Immich MCP: fotos, álbumes y personas

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Immich, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Immich

Deja que tu IA lea tu biblioteca de fotos de Immich: cuántas fotos y vídeos tienes, tus álbumes y con quién se comparten, la fecha, el lugar, la cámara y las personas de una foto, las personas que Immich ha reconocido y cuántas imágenes se tomaron cada mes. Solo lectura: nunca sube, edita ni elimina nada. Funciona con Immich 3.0 o posterior autoalojado.

Configuración

La configuración lleva unos 3 minutos. Necesitas Immich 3.0 o posterior y una clave de API del usuario cuya biblioteca deba leer la IA. No hace falta una cuenta de administrador.

1. Establece IMMICH_URL con la dirección desde la que abres Immich, sin /api y sin barra final, por ejemplo https://photos.example.com o http://192.168.1.10:2283 (el puerto por defecto es 2283).
2. Inicia sesión en Immich con ese usuario, abre Account Settings → API Keys → New API Key y concede únicamente user.read, asset.read, asset.statistics, album.read y person.read. Copia la clave en IMMICH_API_KEY; Immich la muestra una sola vez. Se envía en la cabecera x-api-key.
3. Instala el conector y ejecuta immich_get_my_user: muestra el usuario asociado a la clave, junto con su cuota y uso de almacenamiento.

Dónde se ejecuta Immich: en AnythingMCP autoalojado, Immich suele estar en un servidor doméstico o un NAS (http://192.168.x.x:2283). La protección SSRF de salida bloquea por defecto las direcciones privadas y locales, así que un administrador debe permitir el host mediante SSRF_ALLOWED_HOSTS o la lista de permitidos en los ajustes de administración. AnythingMCP Cloud solo puede acceder a un servidor Immich expuesto a internet público mediante HTTPS, por ejemplo detrás de un proxy inverso. Una IP privada o un nombre de host local se rechaza, y la lista de permitidos no se puede modificar en Cloud.

Qué lee: el recuento de fotos y vídeos con immich_get_asset_statistics (sin filtros cuenta todos los activos que no están en la papelera, incluidos los archivados; visibility=timeline coincide con la línea de tiempo principal); los álbumes y con quién se comparten (immich_list_albums, immich_get_album); una foto o vídeo con fechas, cámara, objetivo, exposición, GPS, ciudad, país, personas y etiquetas (immich_get_asset); las personas reconocidas por nombre (immich_search_people); los lugares por nombre con sus coordenadas (immich_search_places); y los recuentos por mes por persona, álbum, etiqueta o favoritos (immich_get_timeline_buckets). Todos los ids son UUID.

Privacidad: una clave de Immich solo ve la biblioteca del usuario que la creó, más los álbumes compartidos con ese usuario, y eso incluye sus fotos, caras y ubicaciones. Asigna este conector únicamente a servidores MCP cuyos usuarios puedan ver esta biblioteca. Las rutas de archivos del servidor, las sumas de comprobación, los thumbhashes, los ids de OAuth y las claves de licencia se eliminan de las respuestas.

Errores comunes: 401 significa que la clave es incorrecta o se eliminó; 401 "Elevated permission is required" se refiere a la carpeta bloqueada, que una clave de API no puede leer. 403 "Missing required permission" significa que a la clave le falta uno de los cinco permisos. 400 "Not found or no ... access" significa que en esta biblioteca no hay ningún activo o álbum con ese id (Immich responde 400, no 404). 400 "Validation failed" significa que un id no es un UUID, que un valor no está permitido o que falta name en una búsqueda de personas o lugares. 404 en todas las llamadas significa que IMMICH_URL es incorrecta o termina en /api.

El conector es de solo lectura: no sube, edita, marca como favorito, archiva, envía a la papelera ni elimina activos, no modifica álbumes, etiquetas ni personas, no descarga originales, miniaturas ni vídeos, no ejecuta búsquedas inteligentes ni por metadatos, y no abre la carpeta bloqueada, los enlaces compartidos, los recuerdos, los endpoints de administración ni la gestión de claves de API.

Requisitos previos: IMMICH_URL, IMMICH_API_KEY

Instala el conector en local

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

Abre http://localhost:3000/connectors/store, elige Immich y pega las variables de entorno indicadas en los requisitos previos.

Herramientas disponibles

Siguientes pasos

• Conectar con Claude
• Conectar con ChatGPT