Immich Photo Manager
Gestión de fotos con IA para Immich
El Problema
Tienes miles de fotos en Immich pero encontrar algo significa hacer scroll sin fin. La búsqueda se limita a metadatos básicos. Crear álbumes es manual y tedioso. Capturas de pantalla, duplicados y fotos borrosas llenan tu biblioteca.
La Solución
Dile a Claude lo que quieres en lenguaje natural. El servidor MCP se encarga de todo — búsqueda inteligente via CLIP, álbumes geográficos automáticos, limpieza asistida de capturas y duplicados. Nunca borra sin preguntar.
¿Por qué immich-photo-manager?
Gestionar una gran biblioteca de fotos no debería requerir escribir scripts. Este servidor MCP convierte el lenguaje natural en gestión inteligente de tu biblioteca.
| Manual / Scripts | immich-photo-manager | |
|---|---|---|
| 🔍 | Escribir llamadas API, parsear JSON | Consultas en lenguaje natural |
| 🌎 | Exportar GPS, clusterizar manualmente | GPS + CLIP + coincidencia temporal automática |
| 🗑 | Hashear archivos, comparar checksums | Hashing perceptual entre importaciones |
| 📊 | Consultar BD, construir informes | Evaluación integral con un comando |
| 📅 | Consultas SQL sobre timestamps | Detección automática de huecos |
| 🔒 | Riesgo de errores de borrado | Seguridad primero, con aprobación |
Características
Búsqueda Inteligente
Busca tus fotos con lenguaje natural via embeddings CLIP. "Atardecer en la playa" encuentra exactamente lo que esperas.
Álbumes Geográficos
Organiza fotos automáticamente por ubicación usando datos GPS y CLIP. Álbumes curados con 20-50 fotos por lugar.
Limpieza de Biblioteca
Detecta capturas de pantalla, duplicados y fotos de baja calidad con análisis multi-señal. Revisa antes de cualquier acción.
Galerías HTML Interactivas
Di 'muéstrame fotos de Barcelona' y obtén una galería HTML autónoma — tema claro/oscuro, 4 modos de vista, presentación a pantalla completa, gestos táctiles, carga lazy. Se abre en cualquier navegador, funciona offline.
19 Herramientas MCP
Gestión completa de biblioteca: verificaciones de salud, info de assets, búsqueda de metadatos, CRUD de álbumes, enlaces compartidos, miniaturas y actualización de álbumes.
Seguridad Primero
Nunca borra automáticamente. Siempre muestra hallazgos y pide confirmación. Tus fotos están seguras.
Panel de Acciones Cowork
Selecciona fotos en cualquier galería, haz clic en una acción y el comando formateado se copia a tu portapapeles — listo para pegar en Cowork. 11 acciones con código de color desde Crear Álbum hasta Eliminar.
Arquitectura
Immich Photo Manager es un servidor Go que habla el Model Context Protocol (MCP) via HTTP Streamable. Claude se conecta a él, y traduce las peticiones en llamadas al API REST de Immich.
19 herramientas organizadas en 6 categorías: Salud (3), Assets (2), Búsqueda (2), Álbumes (8), Compartir (3) y Miniaturas (2). Cada herramienta mapea directamente a endpoints del API de Immich con inteligencia añadida para curación y filtrado.
Inicio Rápido
Conéctate a tu instancia Immich en menos de dos minutos.
Luego añádelo a tu configuración de Claude (.mcp.json):
Skills Especializados
Flujos de trabajo pre-construidos que combinan múltiples herramientas MCP en operaciones multi-paso. Una petición en lenguaje natural activa todo el pipeline.
| Skill | Descripción |
|---|---|
/immich-status | Verificar salud del servidor, conteo de fotos/vídeos y uso de almacenamiento |
/create-album | Crear álbumes geográficos curados con 20-50 fotos por ubicación |
/cleanup | Detección multi-señal de capturas, duplicados y fotos de baja calidad |
/my-travels | Generar álbumes de viaje a partir de datos GPS de toda tu biblioteca |
/duplicate-report | Análisis profundo de duplicados entre fuentes usando hashing perceptual |
/library-health | Inventario de assets, calidad de metadatos, desglose de almacenamiento y recomendaciones |
/timeline-gaps | Identificar meses faltantes, periodos escasos y riesgos de cobertura |
/metadata-fixer | Reparar fechas rotas, GPS faltante, zonas horarias incorrectas via interpolación de vecinos |
/auto-album-curator | Encontrar nuevas fotos que coincidan con álbumes existentes via GPS, CLIP y patrones temporales |
/storage-optimizer | Identificar pares RAW+JPEG, vídeos sobredimensionados y archivos que acaparan espacio |
/people-report | Insights de reconocimiento facial: frecuencia, clusters sin nombre, co-ocurrencia |
19 Herramientas MCP
Gestión completa de biblioteca Immich organizada en 6 categorías. Cada herramienta mapea directamente a endpoints del API de Immich con inteligencia añadida.
| Categoría | Herramientas |
|---|---|
| Health | ping, get_server_version, get_statistics |
| Assets | get_asset_info, get_map_markers |
| Search | search_metadata, search_smart (CLIP) |
| Albums | list_albums, get_album, create_album, update_album, delete_album, add_assets_to_album, remove_assets_from_album |
| Sharing | list_shared_links, create_shared_link, delete_shared_link |
| Thumbnails | get_album_thumbnails, get_asset_thumbnail |
También disponible como plugin Cowork instalable para Claude Desktop. Instala immich-photo-manager.plugin y obtén 5 comandos slash listos: /immich-status, /create-album, /cleanup, /my-travels, /photo-search. Sin terminal, sin archivos de configuración — instalar y listo.
Requisitos
Una instancia Immich en funcionamiento y un cliente Claude — es todo lo que necesitas.
| Requisito | Detalle |
|---|---|
| Immich | v1.90+ |
| Go | 1.24+ |
| macOS / Linux | Binario Go, sin dependencias nativas |
| Claude | Claude Desktop (Cowork) o Claude Code CLI |
Construido Con
Un binario Go único con dependencias mínimas. Sin requisitos de ejecución más allá de una instancia Immich en funcionamiento.
- Go 1.24+ — Compilación rápida, binario único
- mcp-go v0.32.0 — SDK del Model Context Protocol
- Immich REST API — Gestión completa de biblioteca
- Embeddings CLIP — Búsqueda de fotos con lenguaje natural via ML de Immich
Construyo las herramientas que me faltan, y las regalo.
Si alguna te ahorró tiempo, un café mantiene la siguiente en camino.
¿Listo para organizar tus fotos?
Immich Photo Manager es gratuito, código abierto y listo para usar con tu instancia Immich.