Immich MCP-Server für Fotos, Alben und Personen

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Immich, füge deine Zugangsdaten ein, erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

Immich

Lass deine KI deine Immich-Fotobibliothek lesen: wie viele Fotos und Videos du hast, deine Alben und mit wem sie geteilt sind, Datum, Ort, Kamera und Personen eines Fotos, die von Immich erkannten Personen und wie viele Bilder pro Monat aufgenommen wurden. Nur lesend: Es lädt nie etwas hoch, bearbeitet oder löscht nichts. Funktioniert mit self-hosted Immich 3.0 oder neuer.

Einrichtung

Die Einrichtung dauert etwa 3 Minuten. Du brauchst Immich 3.0 oder neuer und einen API-Key des Benutzers, dessen Bibliothek die KI lesen soll. Ein Admin-Konto ist nicht nötig.

1. Setze IMMICH_URL auf die Adresse, unter der du Immich öffnest, ohne /api und ohne abschließenden Schrägstrich, zum Beispiel https://photos.example.com oder http://192.168.1.10:2283 (der Standardport ist 2283).
2. Melde dich bei Immich als dieser Benutzer an, öffne Account Settings → API Keys → New API Key und vergib nur user.read, asset.read, asset.statistics, album.read und person.read. Kopiere den Key in IMMICH_API_KEY; Immich zeigt ihn nur einmal an. Er wird im Header x-api-key gesendet.
3. Installiere den Connector und führe immich_get_my_user aus: Das Tool zeigt den Benutzer hinter dem Key sowie sein Speicherkontingent und die Nutzung.

Wo Immich läuft: Bei self-hosted AnythingMCP läuft Immich meist auf einem Heimserver oder NAS (http://192.168.x.x:2283). Der ausgehende SSRF-Schutz blockiert standardmäßig private und lokale Adressen, daher muss ein Administrator den Host über SSRF_ALLOWED_HOSTS oder die Allowlist in den Admin-Einstellungen freigeben. AnythingMCP Cloud erreicht nur einen Immich-Server, der über HTTPS im öffentlichen Internet erreichbar ist, zum Beispiel hinter einem Reverse Proxy. Eine private IP oder ein lokaler Hostname wird abgelehnt, und die Allowlist lässt sich in der Cloud nicht ändern.

Was gelesen wird: Foto- und Videoanzahl mit immich_get_asset_statistics (ohne Filter werden alle Assets gezählt, die nicht im Papierkorb sind, auch archivierte; visibility=timeline entspricht der Haupt-Timeline); Alben und mit wem sie geteilt sind (immich_list_albums, immich_get_album); ein Foto oder Video mit Datum, Kamera, Objektiv, Belichtung, GPS, Stadt, Land, Personen und Tags (immich_get_asset); erkannte Personen nach Namen (immich_search_people); Orte nach Namen mit Koordinaten (immich_search_places); und Anzahlen pro Monat nach Person, Album, Tag oder Favoriten (immich_get_timeline_buckets). Alle IDs sind UUIDs.

Datenschutz: Ein Immich-Key sieht nur die Bibliothek des Benutzers, der ihn erstellt hat, sowie mit diesem Benutzer geteilte Alben – und damit dessen Fotos, Gesichter und Standorte. Weise diesen Connector nur MCP-Servern zu, deren Benutzer diese Bibliothek sehen dürfen. Dateipfade des Servers, Prüfsummen, Thumbhashes, OAuth-IDs und Lizenzschlüssel werden aus den Antworten entfernt.

Häufige Fehler: 401 bedeutet, dass der Key falsch ist oder gelöscht wurde; 401 „Elevated permission is required“ betrifft den gesperrten Ordner, den ein API-Key nicht lesen kann. 403 „Missing required permission“ bedeutet, dass dem Key eine der fünf Berechtigungen fehlt. 400 „Not found or no ... access“ bedeutet, dass es in dieser Bibliothek kein Asset und kein Album mit dieser ID gibt (Immich antwortet mit 400, nicht mit 404). 400 „Validation failed“ bedeutet, dass eine ID keine UUID ist, ein Wert nicht erlaubt ist oder bei einer Personen- oder Ortssuche name fehlt. 404 bei jedem Aufruf bedeutet, dass IMMICH_URL falsch ist oder auf /api endet.

Der Connector ist nur lesend: Er lädt keine Assets hoch, bearbeitet sie nicht, markiert sie nicht als Favoriten, archiviert sie nicht, verschiebt sie nicht in den Papierkorb und löscht sie nicht, ändert keine Alben, Tags oder Personen, lädt keine Originale, Thumbnails oder Videos herunter, führt keine Smart- oder Metadatensuche aus und öffnet weder den gesperrten Ordner noch geteilte Links, Erinnerungen, Admin-Endpunkte oder die Verwaltung von API-Keys.

Voraussetzungen: IMMICH_URL, IMMICH_API_KEY

Den Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Immich und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden