Immich Photo Manager
插件 已验证 活跃MCP server for intelligent photo management with Immich — interactive HTML galleries with Cowork Actions Panel, geographic album curation, library cleanup, duplicate detection, people & face management, trash management, metadata repair, and 36 MCP tools. The first MCP server for self-hosted photo management.
To allow AI assistants to intelligently manage and interact with a self-hosted Immich photo library, automating tasks like search, organization, cleanup, and analysis without manual scripting.
功能
- AI-powered photo search (CLIP, text, metadata)
- Automated geographic and thematic album creation
- Intelligent library cleanup (screenshots, duplicates, low quality)
- Metadata repair and validation
- Comprehensive library health and storage reports
- Interactive HTML gallery generation
使用场景
- Find specific photos using natural language queries.
- Automatically create albums for trips, locations, or events.
- Reclaim disk space by removing duplicate or unwanted photos.
- Analyze and fix inconsistencies in photo metadata (dates, GPS).
- Visualize photo library organization and identify gaps.
非目标
- Directly managing the Immich server installation or infrastructure.
- Performing actions not related to photo library organization (e.g., managing users, system settings).
- Replacing the core Immich UI for all photo browsing.
实践
- Metadata Repair
- Library Cleanup
- Album Curation
- Photo Search
- Reporting & Analytics
先决条件
- Running Immich instance (v1.90+)
- Immich API key
- Python 3.10+
安装
请先添加 Marketplace
/plugin marketplace add drolosoft/immich-photo-manager/plugin install immich-photo-manager@drolosoft-marketplace包含 12 个扩展
Skill (12)
Create, curate, and publish Immich albums organized by geography, theme, or custom criteria. Use when the user says "create an album", "organize my photos by location", "make a gallery album", "curate photos from Italy", "publish album", "geographic albums", "album from my trip to X", "share this album", or any variation of creating, managing, or publishing photo albums in Immich. Also triggers on "what albums do I have", "list albums", "album stats", "show me photos from", "generate gallery for", "show me the album".
Monitor your Immich library for new photos that match existing albums and suggest additions. Keeps albums fresh by finding new photos that belong in existing collections based on GPS location, visual similarity (CLIP), and date patterns. Use when the user says "update my albums", "refresh albums", "new photos for albums", "curate albums", "auto-curate", "keep albums fresh", "album suggestions", "what new photos belong in my albums", "smart album update", or any variation of wanting to keep their albums up to date with recent imports.
Run a comprehensive duplicate analysis on an Immich photo library using perceptual hashing. Finds cross-source duplicates (e.g. Apple Photos vs Google Photos exports), internal duplicates, and generates a detailed report with removal recommendations. Use when the user says "find duplicates", "duplicate report", "how many duplicates", "library health check", "photo dedup report", "run duplicate analysis", "compare my photo sources", or any variation of wanting to understand duplicate photos across import sources.
Run a comprehensive health check on an Immich photo library — asset counts, storage usage, metadata completeness, orphaned files, and quality indicators. Use when the user says "library health", "health report", "library status", "library audit", "how healthy is my library", "photo stats", "library overview", "what's in my library", "library report", or any variation of wanting a comprehensive overview of their photo library's state.
Scan for and fix broken or missing photo metadata — dates, GPS coordinates, timezone offsets, and camera info. Detects suspicious patterns (midnight/noon timestamps, missing GPS on geotagged trips) and proposes corrections using folder structure, neighboring photos, and EXIF inference. Use when the user says "fix metadata", "fix dates", "wrong dates", "missing GPS", "metadata repair", "exif fix", "photos have wrong time", "noon dates", "midnight timestamps", "fix my photo dates", "metadata fixer", or any variation of wanting to repair photo metadata.
Generate a report on people in your Immich photo library — unique faces detected, photos per person, unnamed faces, people appearing together, and face recognition quality. Use when the user says "people report", "faces report", "who's in my library", "unnamed faces", "face recognition", "how many people", "people stats", "who appears most", "tag my faces", "face cleanup", "person report", or any variation of wanting to understand the people in their photo library.
Detect and remove screenshots, duplicates, and low-quality photos from an Immich library. Use when the user says "clean up my photos", "remove screenshots", "find duplicates", "deduplicate", "photo cleanup", "library cleanup", "how many screenshots do I have", "free up space", "remove junk photos", or any variation of cleaning, deduplicating, or optimizing a photo library.
Search and explore an Immich photo library using natural language, GPS locations, dates, people, cameras, and AI-powered visual search (CLIP). Use when the user says "find photos of", "search my photos", "show me pictures from", "where are my photos of", "do I have photos of", "find all screenshots", "photos taken with", "photos from 2019", "photos near", "photos of [person]", or any variation of searching, browsing, or exploring their photo library.
Bulk rotate photos in an Immich library — by album or asset IDs. Non-destructive, original files are never modified. Supports undo/revert. Use when the user says "rotate photos", "rotate album", "fix rotation", "photos are sideways", "rotate 90", "rotate clockwise", "rotate counterclockwise", "upside down photos", "wrong orientation", "bulk rotate", "rotate multiple", or any variation of wanting to rotate one or more photos.
Analyze disk usage in an Immich photo library and identify opportunities to reclaim storage — redundant RAW+JPEG pairs, oversized videos, bloated sidecar files, and format inefficiencies. Use when the user says "storage", "disk space", "what's eating my disk", "free up space", "storage report", "disk usage", "large files", "optimize storage", "space analysis", "how much space", "biggest files", or any variation of wanting to understand or reduce storage usage.
Analyze the photo timeline to find suspicious gaps — months or years with zero or very few photos. Helps identify failed imports, missing backups, or periods where photos exist in only one ecosystem. Use when the user says "timeline gaps", "missing months", "missing photos", "are there gaps", "what months am I missing", "photo timeline", "coverage check", "find missing periods", "when am I missing photos", or any variation of wanting to find holes in their photo timeline.
Generate an interactive map showing every location where photos were taken, clustered by city/region with photo counts, date ranges, and album links. Outputs a standalone HTML file with Leaflet.js that can be hosted or viewed locally. Use when the user says "travel map", "show me everywhere I've been", "photo map", "map my photos", "where have I traveled", "GPS map", "location map", "map of my trips", "generate a map", "interactive map", or any variation of wanting to see their photos plotted on a map.