Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager==2.0.11"
      ],
      "env": {
        "IMMICH_BASE_URL": "${IMMICH_BASE_URL}",
        "IMMICH_API_KEY": "${IMMICH_API_KEY}"
      }
    }
  }
}

claude mcp add immich-photo-manager -e "IMMICH_BASE_URL=${IMMICH_BASE_URL}" -e "IMMICH_API_KEY=${IMMICH_API_KEY}" -- uvx immich-photo-manager==2.0.11

[mcp_servers.immich-photo-manager]
command = "uvx"
args = ["immich-photo-manager==2.0.11"]
env = { "IMMICH_BASE_URL" = "${IMMICH_BASE_URL}", "IMMICH_API_KEY" = "${IMMICH_API_KEY}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "immich-photo-manager": {
      "type": "local",
      "command": [
        "uvx",
        "immich-photo-manager==2.0.11"
      ],
      "enabled": true,
      "environment": {
        "IMMICH_BASE_URL": "{env:IMMICH_BASE_URL}",
        "IMMICH_API_KEY": "{env:IMMICH_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager==2.0.11"
      ],
      "env": {
        "IMMICH_BASE_URL": "${IMMICH_BASE_URL}",
        "IMMICH_API_KEY": "${IMMICH_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=immich-photo-manager&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJpbW1pY2gtcGhvdG8tbWFuYWdlcj09Mi4wLjExIl0sImVudiI6eyJJTU1JQ0hfQkFTRV9VUkwiOiIke0lNTUlDSF9CQVNFX1VSTH0iLCJJTU1JQ0hfQVBJX0tFWSI6IiR7SU1NSUNIX0FQSV9LRVl9In19"
}

{
  "servers": {
    "immich-photo-manager": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "immich-photo-manager==2.0.11"
      ],
      "env": {
        "IMMICH_BASE_URL": "${IMMICH_BASE_URL}",
        "IMMICH_API_KEY": "${IMMICH_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "immich-photo-manager": {
      "command": "uvx",
      "args": [
        "immich-photo-manager==2.0.11"
      ],
      "env": {
        "IMMICH_BASE_URL": "${IMMICH_BASE_URL}",
        "IMMICH_API_KEY": "${IMMICH_API_KEY}"
      }
    }
  }
}

extensions:
  "immich-photo-manager":
    enabled: true
    name: "immich-photo-manager"
    type: stdio
    cmd: "uvx"
    args:
      - "immich-photo-manager==2.0.11"
    envs:
      "IMMICH_BASE_URL": "${IMMICH_BASE_URL}"
      "IMMICH_API_KEY": "${IMMICH_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${IMMICH_API_KEY}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies100 · weight 15

pass
deps.known_vulnsno known advisory in 37 resolved packages
pass
deps.mcp_sdk_versionmcp 2.2.0, no known advisory
pass
deps.resolvable[email protected] resolved: 37 packages

Tool list unknown · checked 2026-10-19 20:06 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance90

livenessn/a

freshness85

hygiene95

+repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-46d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI36 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`immich-photo-manager`	pypi	2.0.11	uvx	`IMMICH_API_KEY`
`ghcr.io/drolosoft/immich-photo-manager:2.0.11`	oci	unpinned	docker	`IMMICH_API_KEY`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.drolosoft/immich-photo-manager",
  "title": "Immich Photo Manager",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "2.0.11",
  "packages": [
    {
      "version": "2.0.11",
      "transport": {
        "type": "stdio"
      },
      "identifier": "immich-photo-manager",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "environmentVariables": [
        {
          "name": "IMMICH_BASE_URL",
          "isRequired": true,
          "description": "URL of your Immich server, for example https://photos.example.com"
        },
        {
          "name": "IMMICH_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "Immich API key (Account Settings, API Keys). Both variables can also be set later from the client with the update_credentials tool."
        }
      ]
    },
    {
      "transport": {
        "url": "http://localhost:8626/mcp",
        "type": "streamable-http"
      },
      "identifier": "ghcr.io/drolosoft/immich-photo-manager:2.0.11",
      "runtimeHint": "docker",
      "registryType": "oci",
      "runtimeArguments": [
        {
          "name": "-p",
          "type": "named",
          "value": "8626:8626",
          "isRequired": true,
          "description": "Publish the MCP port; the server listens on 8626 inside the container"
        },
        {
          "name": "-v",
          "type": "named",
          "value": "{exports_dir}:/data",
          "variables": {
            "exports_dir": {
              "format": "filepath",
              "description": "Host directory to mount on /data"
            }
          },
          "description": "Directory on the host for the PDFs and zips the tools write, and for credentials set from the client"
        }
      ],
      "environmentVariables": [
        {
          "name": "IMMICH_BASE_URL",
          "description": "URL of your Immich server. Optional at start: without it every tool answers with the fix and one update_credentials call connects the container."
        },
        {
          "name": "IMMICH_API_KEY",
          "isSecret": true,
          "description": "Immich API key"
        },
        {
          "name": "MCP_ALLOWED_HOSTS",
          "description": "Extra hostnames the container may be reached under (a reverse proxy, another container). DNS-rebinding protection stays on."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/drolosoft/immich-photo-manager",
    "source": "github"
  },
  "websiteUrl": "https://github.com/drolosoft/immich-photo-manager",
  "description": "Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports. 94 tools."
}