immich

Connects to an Immich self-hosted photo management server to search, browse, and retrieve photos, albums, and assets. Requires Immich API key and base URL.

Python

developer-tools

backend

Add to Your Project

Copy this JSON into your .mcp.json to enable this server

Add to your .mcp.json:

{
  "mcpServers": {
    "immich": {
      "command": "python3",
      "args": [
        "-m",
        "immich_mcp_server"
      ],
      "env": {
        "PYTHONPATH": "${CLAUDE_PLUGIN_ROOT}/src",
        "MCP_TRANSPORT": "stdio",
        "IMMICH_API_KEY": "your-api-key-here",
        "IMMICH_BASE_URL": "https://your-immich-server.com",
        "IMMICH_CACHE_DIR": "${CLAUDE_PLUGIN_ROOT}/.mcpb-cache"
      }
    }
  }
}

Replace placeholder values for: IMMICH_API_KEY

Security Considerations

Review these signals before enabling this server

Requires secrets

This MCP server needs API keys or credentials. Configure them in your environment before use.

Details

Server configuration and connection parameters

Commandpython3

Access Levelwrite

Arguments

Command-line arguments passed to the server process

-mimmich_mcp_server

Environment Variables

Environment variables set when the server starts

PYTHONPATH=${CLAUDE_PLUGIN_ROOT}/src

MCP_TRANSPORT=stdio

IMMICH_API_KEY=your-api-key-here

IMMICH_BASE_URL=https://your-immich-server.com

IMMICH_CACHE_DIR=${CLAUDE_PLUGIN_ROOT}/.mcpb-cache

Required Secrets

Sensitive values you must provide — never committed to source control

IMMICH_API_KEY

Stats

LanguageHTML

Stars18

Forks6

MaintenanceExcellent

Last CommitMay 20, 2026

Actions

Stats

Actions