n8n-nodes-immich

This is an n8n community node that lets you use Immich in your n8n workflows.

Immich is a high-performance, self-hosted photo and video management solution. With this node, you can automate photo organization, search for images, manage albums, and integrate your Immich library with other services in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Usage Resources Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node supports the following resources and operations:

Asset (Photos & Videos)

• Get Many: Retrieve multiple assets with filtering options (favorites, archived, date range)
• Get: Get a single asset by ID with full metadata
• Update: Modify asset properties (favorite status, archive status, description, location, date)
• Delete: Permanently remove an asset
• Get Statistics: Retrieve statistics about all assets

Album

• Get Many: List all albums (optionally include shared albums)
• Get: Retrieve a single album with its assets
• Create: Create a new album with name, description, and initial assets
• Update: Update album name and description
• Add Assets: Add photos/videos to an existing album
• Remove Assets: Remove photos/videos from an album
• Delete: Permanently delete an album

Search

• Smart Search: AI-powered content search using natural language queries (e.g., "beach sunset", "birthday party")
• Metadata Search: Search assets by EXIF metadata (location, camera make/model, date taken)

Credentials

To use this node, you need to have a self-hosted Immich instance and generate an API key.

Prerequisites

1. A running Immich instance (self-hosted)
2. Access to the Immich web interface

Setting up credentials

1. Log into your Immich web interface
2. Navigate to Account Settings (click your profile icon)
3. Go to the API Keys section
4. Click Create New API Key
5. Give it a descriptive name (e.g., "n8n Workflow Automation")
6. Copy the generated API key (it will only be shown once)

Configuring in n8n

When setting up the Immich credentials in n8n, you'll need to provide:

• Base URL: The URL of your Immich instance (e.g., https://immich.example.com) - include https:// but do not include /api
• API Key: The API key you generated from Immich

The node will automatically test the connection when you save the credentials.

Compatibility

• Minimum n8n version: 1.0.0
• Tested with: n8n 1.x
• Immich version: Compatible with recent Immich versions (API-based integration)

Note: This is a community-maintained node. As Immich evolves, some operations may require updates.

Usage

Example Workflows

Auto-organize photos by date:

1. Trigger: Schedule (daily)
2. Immich > Asset > Get Many (updatedAfter: yesterday)
3. For each asset, create or find album by date
4. Immich > Album > Add Assets

Search and share photos:

1. Trigger: Manual or Webhook
2. Immich > Search > Smart Search (query from trigger)
3. Create album with results
4. Share album (via future Shared Link resource)

Backup automation:

1. Trigger: Schedule (weekly)
2. Immich > Asset > Get Many
3. Download assets to external storage
4. Mark as archived in Immich

Tips

• Use the Asset ID from one operation as input to another (e.g., get assets, then add to album)
• The Smart Search requires Immich's machine learning features to be enabled
• When working with multiple assets, use comma-separated IDs for bulk operations
• Date filters use ISO 8601 format (automatically handled by n8n's dateTime picker)

Resources

• n8n community nodes documentation
• Immich official website
• Immich documentation
• Immich API documentation
• Immich GitHub repository

Version history

0.1.0 (Current)

Initial release with Phase 1 MVP functionality:

• Asset resource (5 operations)
• Album resource (7 operations)
• Search resource (2 operations)
• Self-hosted instance support with custom base URL
• API key authentication

Future Plans

See IMPLEMENTATION_PLAN.md for details on planned features:

• Phase 2: Shared Links, People/Faces, Partner resources
• Phase 3: Server Info, User, Library resources