Immich Photo Manager MCP Server

If your Immich 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 and talks only to your Immich; your originals stay on your server (see what leaves your network).

People who work with albums, claude plugin and cleanup and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-03 · ★ 48 · #12 OF 173 MAINTAINED MEDIA · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Immich Photo Manager

before you install - you'll need

Set IMMICH_BASE_URL, IMMICH_API_KEY, MCP_ALLOWED_HOSTS before connecting.

Claude Code

claude mcp add drolosoft-immich-photo-manager -- uvx immich-photo-manager

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "drolosoft-immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

pypi package immich-photo-manager - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.drolosoft is GitHub-verified and matches the repo owner

03 · What Immich Photo Manager can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v2.0.11 · 2026-09-03

server.json for the official MCP registry, ghcr description, tools section

v2.0.10 · 2026-09-03

demos 13 to 18 from real sessions, bare dates in memories on Immich 3.x

v2.0.9 · 2026-09-03

consistency pass over the 41 new tools, two dual-era bugs, credentials that survive updates

04 · Who maintains Immich Photo Manager

Immich Photo Manager is maintained by drolosoft. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

category
media - ranked #12 of 173 actively-maintained media servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-09-03)
registry
io.github.drolosoft/immich-photo-manager (active, first published 2026-09-03)
packages
pypi:immich-photo-manager · oci:ghcr.io/drolosoft/immich-photo-manager:2.0.11

06 · Immich Photo Manager FAQ

What is Immich Photo Manager?

If your Immich 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 and talks only to your Immich; your originals stay on your server (see what leaves your network).

Is Immich Photo Manager still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-03 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Immich Photo Manager?

Run `uvx immich-photo-manager`. The README documents 3 environment variables (IMMICH_BASE_URL, IMMICH_API_KEY, MCP_ALLOWED_HOSTS) to set first. Set IMMICH_BASE_URL, IMMICH_API_KEY, MCP_ALLOWED_HOSTS before connecting. You can also paste the ready-made client config above.

Does Immich Photo Manager run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Immich Photo Manager