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. Un caos total.
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. Un placer total.
¿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 |
| 🔄 | Rotar fotos de una en una | Rotación masiva de álbumes completos |
| 🔒 | 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 — 3 temas (claro/sistema/oscuro), 4 modos de vista, presentación a pantalla completa, gestos táctiles, carga lazy. Se abre en cualquier navegador, funciona offline.
50 Herramientas MCP
Gestión completa: salud, búsqueda, álbumes CRUD, rotación masiva, etiquetas y organización, subida de fotos, gestión de personas y caras, papelera, detección de duplicados, enlaces compartidos y miniaturas.
Seguridad Primero
Nunca borra automáticamente. Siempre muestra hallazgos y pide confirmación. Tus fotos están seguras.
Rotación Masiva
Selecciona fotos mal orientadas, ponlas en un álbum y rota todo el lote de una vez. No destructivo, acumulativo, y se revierte con un solo comando.
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 Python que habla el Model Context Protocol (MCP) via stdio. Claude se conecta a él, y traduce las peticiones en llamadas al API REST de Immich.
50 herramientas en 10 categorías: Salud (3), Activos (7), Búsqueda (2), Álbumes (7), Compartir (5), Miniaturas (3), Config (2), Personas y Caras (8), Papelera (4), Duplicados (2) y Etiquetas (7).
Inicio Rápido
Conéctate a tu instancia Immich en menos de dos minutos.
Instalar con uvx (recomendado)
Disponible en PyPI. Sin clonar repositorios, sin PYTHONPATH.
Instalar como Plugin de Claude
Configuración manual
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 |
/rotate-photos | Rotar álbumes completos o selecciones — no destructivo, acumulativo, reversión con un clic |
50 Herramientas MCP
Gestión completa de Immich organizada en 10 categorías. Cada herramienta corresponde directamente a un endpoint de la API de Immich.
| Categoría | Herramientas |
|---|---|
| Health | ping, get_server_version, get_statistics |
| Assets | get_asset_info, update_asset_metadata, rotate_assets, revert_asset_edits, get_map_markers, upload_asset, list_assets |
| 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, get_shared_link, update_shared_link, delete_shared_link |
| Thumbnails | get_album_thumbnails, get_asset_thumbnail, get_thumbnails_batch |
| Config | get_connection_info, update_credentials |
| People | list_people, get_person, update_person, merge_people, search_people, get_person_thumbnail, get_asset_faces, reassign_face |
| Trash | delete_assets, empty_trash, restore_trash, restore_assets |
| Duplicates | get_duplicates, resolve_duplicates |
| Tags | list_tags, get_tag, create_tag, update_tag, delete_tag, tag_assets, untag_assets |
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. Requiere Python 3.10+ y pip3 install mcp httpx.
Requisitos
Una instancia Immich en funcionamiento y un cliente Claude — es todo lo que necesitas.
| Requisito | Detalle |
|---|---|
| Immich | v1.90+ |
| Python | 3.10+ |
| Instalación | uvx immich-photo-manager (PyPI) o claude plugin install |
| macOS / Linux | Servidor Python, sin dependencias nativas |
| Clientes MCP | Claude Desktop, Claude Code, Cursor, Windsurf, LM Studio, cualquier cliente MCP |
Construido Con
Un servidor Python ligero con dependencias mínimas. Sin requisitos de ejecución más allá de Python 3.10+ y una instancia Immich en funcionamiento.
- Python 3.10+ — Servidor async, ligero y portable
- mcp (Python SDK) — Model Context Protocol via stdio
- 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.