Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports. 94 tools.
Connect Runs on your machine
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
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
IMMICH_BASE_URLRequired | URL of your Immich server, for example https://photos.example.com |
IMMICH_API_KEYRequired, secret | Immich API key (Account Settings, API Keys). Both variables can also be set later from the client with the update_credentials tool. |
Details
| Package | [email protected] (PYPI, stdio) |
| Package | ghcr.io/drolosoft/immich-photo-manager:2.0.11 (OCI, streamable-http) |
| First published | 3 Sep 2026 |
| Last updated | 3 Sep 2026 |
| Registry name | io.github.drolosoft/immich-photo-manager |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
