Update Immich connection credentials when API key is rotated or server URL changes. Validates new credentials before applying, then persists them and hot-swaps the live connection.
Count assets in your photo library matching filters like place, date, camera, or favorite status—returning just the total number instead of loading full results.
An MCP server for Immich self-hosted photo management that provides AI-accessible tools for browsing, searching, organizing, and managing photo libraries with duplicate detection and safe deletion workflows.
Manage your self-hosted Immich photo library through conversation — natural language search via CLIP, geographic album curation, duplicate detection with perceptual hashing,
Fetch base64-encoded thumbnails for photos in an album, enabling visual HTML gallery creation. Provide album ID, choose size, and set a limit to retrieve image data with filenames and dates.
Retrieve a single photo's thumbnail or preview as an inline image block for visual display in compatible clients. Choose between fast 250px thumbnail or higher-quality 1440px preview.
Extract video frames as images to inspect a clip. Control count, interval, time range, and size; use contact sheets to skim long videos without exceeding limits.
Change a tag's color, applying the update to every asset that uses it. Use this when you need to recolor an existing tag; note that renaming is not supported.
Build a PDF from an Immich album or selected photos/videos, embedding dates, places, camera details, people, and tags. Add captions with your analysis; video frames are included directly in the PDF.
See how many photos were taken or uploaded each day across a date range, revealing gaps, busy periods, and overall library health without listing assets.
Merge duplicate person clusters in your Immich library when the same person is split into multiple faces. Preview first, then confirm to permanently transfer all faces to the target person.
Free up storage by permanently deleting all items in the Immich trash. This destructive, irreversible action purges every trashed asset—confirm before proceeding.
Update an asset in Immich by correcting dates, fixing GPS, adding descriptions, or changing favorite and rating status. Only specified fields are modified and saved permanently.
Locate specific photos and videos by filtering EXIF metadata like city, camera model, date range, or OCR text. Narrow results with favorites, people, tags, albums, and more.