immich-mcp

Verify connectivity and authentication with the Immich server. Returns server version and status.

Discover Immich server features and supported API capabilities.

List assets with optional filters. Returns paginated results.

Get full metadata for a single asset by its ID.

Get direct URLs for viewing or downloading an asset. Returns thumbnail, original file, and Immich web UI links. URLs include the API key as a query parameter for direct browser access.

Upload an asset to Immich from a local file path or a URL. For file paths, the MCP server process must have read access to the file. For URLs (http/https), the server downloads the file then uploads it to Immich.

Update metadata for a single asset (favorite, archived, description, rating).

Update metadata for multiple assets at once. Supports dry_run to preview changes.

Delete one or more assets. Set force=true to permanently delete (skip trash). Always use dry_run=true first to preview.

Get asset counts broken down by type (images, videos, total).

Search assets using metadata filters: date range, type, location, camera model, person, filename.

Semantic search using CLIP/ML. Describe what you're looking for in natural language (e.g. 'sunset at the beach', 'birthday party').

Get discovery data: popular places, recognized people, and notable things in your library.

List all albums. Optionally filter by shared status.

Get full details of an album including its assets.

Create a new album with an optional list of asset IDs.

Update album metadata: name, description, or cover asset.

Delete an album. This does not delete the assets inside it.

Add one or more assets to an album.

Remove one or more assets from an album. The assets themselves are not deleted.

List all recognized people from face recognition. Supports pagination.

Get details for a specific person by ID.

Update a person's name or visibility (hidden/visible).

Merge two person clusters into one. The source person will be merged into the target.

Get asset count statistics for a specific person.

List all tags in the library.

Get details of a specific tag by ID.

Create a new tag. Use '/' as separator for nested tags (e.g. 'Travel/Japan').

Update a tag's name or color.

Delete a tag by ID.

List all shared links.

Get details of a specific shared link by ID.

Create a shareable link for an album or specific assets. Optionally set expiry and password.

Update shared link settings: expiry, password, download permission.

Remove a shared link, revoking access to its content.

List comments and likes for an album, optionally filtered by asset.

Add a comment or like to an album or specific asset within an album.

Delete a comment or like by activity ID.

Get comment count for an album or specific asset within an album.

List all duplicate asset groups detected by Immich. Each group contains assets with matching content hashes. Returns full metadata needed for deletion decisions: file format, size, resolution, favorite status, album membership, Live Photo status.

Delete specific assets from duplicate groups. Always run with dry_run=true first to confirm what will be deleted. Set force=true to permanently delete (bypass trash). Do NOT delete assets that are favorited or belong to albums without explicit user approval.

Dismiss duplicate groups without deleting any assets. Use this when the assets are intentionally kept as separate copies and should no longer appear in the duplicate list. The asset files are NOT deleted — only the duplicate grouping is removed. Always run with dry_run=true first.

Get the profile of the currently authenticated user (name, email, quota, role).