Immich MCP mit Gemini CLI verbinden

💡 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 + Gemini

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 nichts hoch, bearbeitet nichts und löscht nichts. Funktioniert mit self-hosted Immich 3.0 oder neuer.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

IMMICH_URL, IMMICH_API_KEY

Schritt 1 — Zugangsdaten besorgen

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 dessen Speicherkontingent und -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 kann nur einen Immich-Server erreichen, 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 kann in der Cloud nicht geändert werden.

Was gelesen wird: Anzahl der Fotos und Videos mit immich_get_asset_statistics (ohne Filter werden alle Assets gezählt, die nicht im Papierkorb liegen, einschließlich archivierter; visibility=timeline entspricht der Haupt-Timeline); Alben und mit wem sie geteilt sind (immich_list_albums, immich_get_album); ein einzelnes 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, plus die mit diesem Benutzer geteilten Alben, und das bedeutet deren 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“ bezieht sich auf 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 name bei einer Personen- oder Ortssuche 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, favorisiert, archiviert oder löscht sie nicht und verschiebt sie nicht in den Papierkorb, ä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 API-Key-Verwaltung.

Schritt 2 — Adapter 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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Immich-Tools aufrufen.

Verfügbare Tools

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden