immich-photo-manager
installs/mo · pypistarsforks
How to install immich-photo-manager?
drolosoft/immich-photo-manager
$git clone https://github.com/drolosoft/immich-photo-manager📸🧹🗺️ MCP server for intelligent photo management with Immich — search, curate geographic albums, clean up libraries, and publish galleries
README.md
| 1 | <p align="center"> |
| 2 | <img src="assets/icon.png" alt="immich-photo-manager" width="100"> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">immich-photo-manager</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a> |
| 9 | <a href="https://glama.ai/mcp/servers/drolosoft/immich-photo-manager"><img src="https://glama.ai/mcp/servers/drolosoft/immich-photo-manager/badges/score.svg" alt="immich-photo-manager MCP server"></a> |
| 10 | <a href="https://github.com/drolosoft/immich-photo-manager/releases/latest"><img src="https://img.shields.io/github/v/release/drolosoft/immich-photo-manager" alt="GitHub Release"></a> |
| 11 | <a href="https://immich.app"><img src="https://img.shields.io/badge/Immich-ecosystem-blueviolet.svg" alt="Immich"></a> |
| 12 | </p> |
| 13 | |
| 14 | > **MCP server for intelligent photo management with [Immich](https://immich.app) — your self-hosted library, understood.** |
| 15 | |
| 16 | If your [Immich](https://immich.app) library has grown past what you can manage by hand, **immich-photo-manager** gives any AI assistant direct access to your instance — search, organize, deduplicate, and curate albums through natural conversation. Works with Claude, Gemma, or any MCP-compatible client. Runs locally — your photos never leave your server. |
| 17 | |
| 18 | <p align="center"><img src="./assets/demo.gif" alt="immich-photo-manager demo" width="800"></p> |
| 19 | |
| 20 | --- |
| 21 | |
| 22 | ## What It Does |
| 23 | |
| 24 | Say **"create albums for all my trips"** and watch it work: |
| 25 | |
| 26 | <p align="center"><img src="./assets/screenshot-06-geographic-albums.png" alt="Geographic album creation" width="700"></p> |
| 27 | |
| 28 | GPS coordinates, CLIP visual search, and temporal matching — combined in one request to create dozens of curated albums. No scripts, no manual sorting. |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | ## Quick Start |
| 33 | |
| 34 | ### Prerequisites |
| 35 | |
| 36 | - A running [Immich](https://immich.app) instance (self-hosted, v1.90+) |
| 37 | - An Immich API key ([how to create one](https://immich.app/docs/features/command-line-interface#obtain-the-api-key)) |
| 38 | - **Python 3.10+** with `pip` ([download](https://www.python.org/downloads/)) |
| 39 | |
| 40 | ### Install as Claude Plugin (recommended) |
| 41 | |
| 42 | ```sh |
| 43 | git clone https://github.com/drolosoft/immich-photo-manager.git |
| 44 | cd immich-photo-manager |
| 45 | |
| 46 | claude plugin marketplace add . |
| 47 | claude plugin install immich-photo-manager |
| 48 | ``` |
| 49 | |
| 50 | That's it. Ask Claude: **"how healthy is my photo library?"** |
| 51 | |
| 52 | <p align="center"><img src="./assets/screenshot-01-setup.png" alt="Setup complete" width="700"></p> |
| 53 | |
| 54 | > For manual MCP server setup, see **[Getting Started](doc/GETTING-STARTED.md)**. |
| 55 | |
| 56 | ### Works in Claude Code |
| 57 | |
| 58 | The same plugin runs in **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** — search your library, curate albums, and generate galleries right from the terminal. |
| 59 | |
| 60 | <p align="center"><img src="./doc/demos/cc/claude-code-conversation.png" alt="Split screen: Claude Code terminal generating a photo gallery on the left, browser showing the resulting gallery with album cards on the right" width="800"></p> |
| 61 | |
| 62 | > Full conversation transcript: **[Claude Code demo](doc/demos/cc/claude-code-example-demo.txt)** |
| 63 | |
| 64 | ### Works with Any MCP Client |
| 65 | |
| 66 | immich-photo-manager is an **MCP server** — it works with any AI assistant that speaks the Model Context Protocol, not just Claude. |
| 67 | |
| 68 | Use the package entry point directly with `uvx`: |
| 69 | |
| 70 | ```json |
| 71 | { |
| 72 | "mcpServers": { |
| 73 | "immich": { |
| 74 | "command": "uvx", |
| 75 | "args": ["immich-photo-manager"], |
| 76 | "env": { |
| 77 | "IMMICH_BASE_URL": "https://your-immich-server.com", |
| 78 | "IMMICH_API_KEY": "your-api-key" |
| 79 | } |
| 80 | } |
| 81 | } |
| 82 | } |
| 83 | ``` |
| 84 | |
| 85 | `immich-photo-manager` defaults to MCP stdio transport. Set `MCP_TRANSPORT=http` when you want to run the server as a Streamable HTTP service. |
| 86 | |
| 87 | ``` |
| 88 | ============================================================ |
| 89 | IMMICH-PHOTO-MANAGER × GEMMA 4 (LM STUDIO) |
| 90 | ============================================================ |
| 91 | |
| 92 | Immich: https://your-immich-server.com |
| 93 | Model: gemma4-26b-it (local, LM Studio) |
| 94 | Query: "Show me my Lanzarote albums" |
| 95 | |
| 96 | 1. Getting MCP tool schemas... |
| 97 | 50 MCP tools available |
| 98 | |
| 99 | 2. Asking Gemma 4... |
| 100 | Gemma 4 chose: list_albums({}) |
| 101 | |
| 102 | 3. Executing 'list_albums' against Immich... |
| 103 | Found 124 total albums, 14 Lanzarote albums: |
| 104 | - Lanzarote Amarillo (26 photos) |
| 105 | - Lanzarote Rojo (201 photos) |
| 106 | - Lanzarote Azul (187 photos) |
| 107 | - Lanzarote Marrón (208 photos) |
| 108 | - Lanzarote Negro (193 photos) |
| 109 | - Lanzarote Verde (201 photos) |
| 110 | - Lanzarote Gasolina (174 photos) |
| 111 | ... |
| 112 | |
| 113 | 4. Gemma 4 interpreting results... |
| 114 | "I found 14 Lanzarote albums — 7 color-themed with |
| 115 | 1,190 photos and 7 location-specific albums." |
| 116 | |
| 117 | RESULT: Zero cloud dependency — fully self-hosted stack. |
| 118 | ``` |
| 119 | |
| 120 | | Client | Status | |
| 121 | |--------|--------| |
| 122 | | Claude Code | Tested | |
| 123 | | Claude Desktop | Tested | |
| 124 | | LM Studio (Gemma 4) | Tested | |
| 125 | | Cursor, Windsurf, VS Code, Cline, Zed | Compatible (MCP stdio) | |
| 126 | |
| 127 | > Full transcript: **[Gemma 4 demo](doc/demos/cc/lm-studio-gemma4-demo.txt)** · Test script: `test-lmstudio-mcp.py` |
| 128 | |
| 129 | --- |
| 130 | |
| 131 | ## Highlights |
| 132 | |
| 133 | - **AI-powered search** — natu |
People who liked this also viewed
6 picksType
- elevenlabs-mcpThe official ElevenLabs MCP serverMCP ServersJul 2026
- MonetEdit Videos and Design Images with Claude code or CodexMCP ServersJul 2026
- scribe.jsJavaScript OCR and text extraction for images and PDFs.MCP ServersJul 2026
- gliana-aiPay-per-call generative AI — 60+ models (image, video, music, speech). No signup, no API key; pay per call from your wallet over MPP/x402.MCP Serversrecently
- nanobanana-mcp-serverAI image generation MCP server powered by Google Gemini, with smart model selection and 4K outputMCP ServersMay 2026
- FramesailCreate long-form (faceless YouTube) videos end to end from any MCP client: script, locked character references, storyboard, voiceover, and final video editing — with characters and style held consistent across every shot. Making long-form MCP Serversrecently
