Manage your self-hosted Immich photo library through conversation — natural language search via CLIP, geographic album curation, duplicate detection with perceptual hashing, library health audits, and interactive HTML galleries. Claude Code plugin with 21 MCP tools, 11 skills, 5 commands.
Overview
What it does
immich-photo-manager is a Claude Code plugin that connects to your self-hosted Immich instance and lets you manage your photo library through conversation.
- "Show me photos from Italy" → CLIP-powered visual search finds them
- "Create albums for everywhere I've traveled"→ GPS clustering builds dozens of curated albums
- "Find duplicates" → Perceptual hashing catches re-encoded copies across Apple Photos and Google Takeout imports
- "How healthy is my library?" → Full audit of metadata, storage, and timeline gaps
What's included
- 21 MCP tools — search, albums, thumbnails, sharing, credentials
- 11 skills — cleanup, duplicate detection, geographic albums, travel maps, metadata repair, storage optimization, people reports
- 5 slash commands — /cleanup, /create-album, /my-travels, /immich-status, /setup
- Interactive HTML galleries — self-contained files with embedded thumbnails, 3 themes, slideshow, keyboard navigation
Install
git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
claude plugin marketplace add .
claude plugin install immich-photo-manager
Requirements
- A running Immich instance (v1.90+)
- An Immich API key
- Python 3.10+
MIT licensed. Plugin scanner score: 100/100.
Server Config
{
"mcpServers": {
"immich": {
"command": "python3",
"args": [
"-m",
"immich_mcp_server"
],
"env": {
"PYTHONPATH": "${CLAUDE_PLUGIN_ROOT}/src",
"MCP_TRANSPORT": "stdio",
"IMMICH_BASE_URL": "https://your-immich-server.com",
"IMMICH_API_KEY": "YOUR-API-KEY-HERE"
}
}
}
}