Immich Photo Manager · MCP Server

Beschreibung des Anbieters

Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports. 94 tools.

Werkzeuge

list_tags

List all tags in the library. Use this to discover existing tags before creating new ones or to find a tag ID for tagging operations. Read-only.… Angabe des Anbieters · Beleg 5

get_tag

Get details for a specific tag. Use this to inspect a tag's properties. Read-only. Args: tag_id: The tag's UUID (from list_tags).… Angabe des Anbieters · Beleg 5

create_tag

Create a new tag for categorizing assets. Use list_tags first to avoid duplicates. Side effect: creates a new tag in Immich. Args: name: Tag display name (e.g.… Angabe des Anbieters · Beleg 5

update_tag

Update a tag's color. Side effect: changes apply to all assets using this tag.… Angabe des Anbieters · Beleg 5

delete_tag

Delete a tag and remove it from all assets. The assets themselves are unaffected. Side effect: permanently deletes the tag (cannot be undone). Args: tag_id: The tag's UUID to delete.… Angabe des Anbieters · Beleg 5

tag_assets

Apply a tag to multiple assets at once. Use this to bulk-categorize photos (e.g. tag all vacation photos). Side effect: adds tag association to assets.… Angabe des Anbieters · Beleg 5

untag_assets

Remove a tag from multiple assets. The tag itself remains; only the association is removed. Side effect: removes tag-to-asset links. Args: tag_id: The tag UUID to remove from assets.… Angabe des Anbieters · Beleg 5

review_assets

Remember a review verdict on assets, with the reason, so a later session does not redo the analysis and the why survives.… Angabe des Anbieters · Beleg 6

record_action

Remember something the plugin did to assets and why, for audit or undo: which album they went into and from what prompt, what date they had before a fix, why they were rotated.… Angabe des Anbieters · Beleg 6

get_asset_notes

The plugin's notes on one asset: past review verdicts with reasons and recorded actions, newest last. Empty lists when it was never annotated. Read-only.… Angabe des Anbieters · Beleg 6

get_assets_notes

Which of these assets already carry notes, and their last verdict — the call that lets a cleanup pass skip what an earlier session reviewed.… Angabe des Anbieters · Beleg 6

clear_asset_notes

Forget the plugin's notes on assets (reviews and actions). Only the plugin's own key is removed; metadata other apps stored stays. Side effect: deletes the notes on the server.… Angabe des Anbieters · Beleg 6

delete_assets

Delete assets (soft-delete to trash or permanent). Use this to remove unwanted photos/videos. Default is soft-delete (recoverable via restore_assets).… Angabe des Anbieters · Beleg 7

empty_trash

Permanently delete ALL assets currently in trash. DESTRUCTIVE and IRREVERSIBLE. Use this only after confirming the user wants to purge all trashed items.… Angabe des Anbieters · Beleg 7

restore_trash

Restore ALL trashed assets back to the library. Use this to undo an accidental bulk deletion. For restoring specific assets only, use restore_assets instead.… Angabe des Anbieters · Beleg 7

restore_assets

Restore specific assets from trash back to the active library. Use this to selectively recover accidentally deleted photos. For restoring everything at once, use restore_trash instead.… Angabe des Anbieters · Beleg 7

get_video_frames

Get frames of a video as image blocks, to "watch" a clip.… Angabe des Anbieters · Beleg 8

get_video_frames_json

Frames of a video as base64 JPEG with timestamps, for HTML galleries and skills. Same parameters, gate (confirm above 12) and cap (120) as get_video_frames. Read-only.… Angabe des Anbieters · Beleg 8

list_albums

List all albums in the library with summary info. Use this to discover existing albums before creating new ones or to find an album ID. Read-only.… Angabe des Anbieters · Beleg 9

get_album

Get full details for a specific album including all its asset IDs. Use this to inspect album contents or retrieve asset IDs for further operations (thumbnails, metadata, rotation).… Angabe des Anbieters · Beleg 9

create_album

Create a new album, optionally pre-populated with assets. Use this to organize photos into collections. Side effect: creates a new album in Immich. Args: name: Album display name (e.… Angabe des Anbieters · Beleg 9

update_album

Update an album's name or description. Use this to rename or re-describe an existing album. Side effect: modifies album metadata in Immich. Args: album_id: The album's UUID.… Angabe des Anbieters · Beleg 9

delete_album

Delete an album container. The photos inside are NOT deleted — they remain in the library. Use this to remove unwanted album groupings.… Angabe des Anbieters · Beleg 9

add_assets_to_album

Add existing assets to an album. Use this to curate albums from search results or other asset lists. Assets can belong to multiple albums simultaneously.… Angabe des Anbieters · Beleg 9

remove_assets_from_album

Remove assets from an album without deleting them. The photos remain in the library and other albums. Use this to un-curate mistakenly added assets. Side effect: modifies album membership.… Angabe des Anbieters · Beleg 9

get_asset_info

Get full metadata for a single asset. Use this when you need EXIF details, GPS coordinates, camera info, or file properties for a known asset ID.… Angabe des Anbieters · Beleg 10

update_asset_metadata

Update metadata fields on a specific asset. Use this to fix dates, correct GPS, add descriptions, or change favorite/rating status. Only provided fields are modified.… Angabe des Anbieters · Beleg 10

update_assets_metadata

Update the same metadata fields on many assets in ONE call — the whole roll of a scanned album gets its real date, a trip's photos get their GPS, a selection becomes favorites.… Angabe des Anbieters · Beleg 10

rotate_assets

Apply a non-destructive clockwise rotation to one or more assets. Use this to fix orientation issues. The original file is never modified — rotation is a display transform only.… Angabe des Anbieters · Beleg 10

revert_asset_edits

Remove all non-destructive edits (rotation, crop, mirror) from assets, restoring original appearance. Use this to undo rotate_assets or any other display transforms.… Angabe des Anbieters · Beleg 10

Voraussetzungen

• IMMICH_BASE_URL · Umgebungsvariable · erforderlich · Beleg 1
• IMMICH_API_KEY · Umgebungsvariable · erforderlich · Beleg 1
• uvx · Paketmanager · erforderlich · Beleg 1
• Python · Laufzeit · erforderlich · Beleg 11
• MCP_ALLOWED_HOSTS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 12
• MCP_TRANSPORT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 13
• MCP_PORT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 13
• MCP_HOST · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 13
• IMMICH_CACHE_DIR · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 14
• IMMICH_CONFIG_HOME · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 14

Installation

uvx immich-photo-manager==2.0.11

Angaben zum Baustein

—: Angabe nicht belegt.

Maintainer

drolosoft

Repository-Lizenz

MIT

Letzter Repository-Commit

2026-10-03

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

—

Bereiche

Content, Büro, Kommunikation

Plattformen

—

Version

2.0.11

Release

v2.0.12

Clients

Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Cline, LM Studio, Zed

Repository-Themen

albums, claude, claude-plugin, cleanup, duplicates, gallery, geolocation, immich, mcp, mcp-server

Homepage

Homepage des Anbieters

Dokumentation

Dokumentation des Anbieters

Zugriffe und Risiken

Regelbasiert abgeleitete Zugriffe

lesen, schreiben, löschen

Authentifizierung

API-Key

Transport

stdio, streamable-http

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe. Vor dem Einsatz Konten, Dateien, Netzwerkverbindungen und Ausführungsrechte im konkreten Paket prüfen. Eine frische Änderung am Repository belegt keine Wartung jeder einzelnen Datei.

Nur die für den Arbeitsablauf nötigen Berechtigungen vergeben und Schreibaktionen mit einem Freigabeschritt absichern. Lizenz und Wartungsdatum sind keine Sicherheitsfreigabe.

Der Lizenzbeleg betrifft das Quellcode-Repository. Einzelne Unterpakete und gehostete Dienste können eigene Bedingungen haben; prüfe sie beim konkreten Installations- oder Diensteangebot.