Immich Photo Manager MCP Server

by drolosoftio.github.drolosoft/immich-photo-managerv2.0.11

Manage a self-hosted Immich photo library: CLIP natural language search, GPS album curation, duplicate detection, library health reports and HTML galleries.

53Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Immich Photo Manager MCP server

claude mcp add immich-photo-manager -e IMMICH_BASE_URL='<immich-base-url>' -e IMMICH_API_KEY='<immich-api-key>' -- uvx immich-photo-manager

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<immich-base-url>",
        "IMMICH_API_KEY": "<immich-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<immich-base-url>",
        "IMMICH_API_KEY": "<immich-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "immich-photo-manager": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<immich-base-url>",
        "IMMICH_API_KEY": "<immich-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager"
      ],
      "env": {
        "IMMICH_BASE_URL": "<immich-base-url>",
        "IMMICH_API_KEY": "<immich-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
IMMICH_BASE_URL	—	—	URL of your Immich server. Optional at start: without it every tool answers with the fix and one update_credentials call connects the container.
IMMICH_API_KEY	—	yes	Immich API key
MCP_ALLOWED_HOSTS	—	—	Extra hostnames the container may be reached under (a reverse proxy, another container). DNS-rebinding protection stays on.

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-10-06 · 5d ago · GitHub · v2.0.13
Package published
no data · npm/PyPI
Registry entry updated
2026-09-03 · 37d ago · official registry · v2.0.11

FAQ

›How do I install the Immich Photo Manager MCP server in Claude Code?

Run: claude mcp add immich-photo-manager -e IMMICH_BASE_URL='<immich-base-url>' -e IMMICH_API_KEY='<immich-api-key>' -- uvx immich-photo-manager. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Immich Photo Manager require an API key?

Yes. It expects IMMICH_API_KEY, of which 1 is a secret.

›Can I use Immich Photo Manager as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Immich Photo Manager in the official MCP registry?

Yes, as io.github.drolosoft/immich-photo-manager.