Immich Photo Manager
Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 2.0.11
- Listing updated
- 4 days ago
About Immich Photo Manager
Immich Photo Manager is an open-source MCP server for design and media. It can run locally on your machine or as a hosted remote server.
Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports. 94 tools.
Install
Run in a terminal
claude mcp add immich-photo-manager --env IMMICH_BASE_URL='<IMMICH_BASE_URL>' --env IMMICH_API_KEY='<IMMICH_API_KEY>' -- uvx immich-photo-managerAdd to claude_desktop_config.json
{
"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
{
"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 .vscode/mcp.json
{
"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 ~/.codeium/windsurf/mcp_config.json
{
"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 your client's MCP settings (most use this shape)
{
"mcpServers": {
"immich-photo-manager": {
"command": "uvx",
"args": [
"immich-photo-manager"
],
"env": {
"IMMICH_BASE_URL": "<IMMICH_BASE_URL>",
"IMMICH_API_KEY": "<IMMICH_API_KEY>"
}
}
}
}Configuration
IMMICH_BASE_URLURL of your Immich server, for example https://photos.example.comRequiredIMMICH_API_KEYImmich API key (Account Settings, API Keys). Both variables can also be set later from the client with the update_credentials tool.RequiredIMMICH_BASE_URLURL 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_KEYImmich API keyMCP_ALLOWED_HOSTSExtra hostnames the container may be reached under (a reverse proxy, another container). DNS-rebinding protection stays on.
Pricing
Open source
Immich Photo Manager FAQ
Is Immich Photo Manager free?
Yes. Immich Photo Manager is open source, so you can use and self-host it for free.
How do I add Immich Photo Manager to Claude Code?
Run this command in your terminal: claude mcp add immich-photo-manager --env IMMICH_BASE_URL='<IMMICH_BASE_URL>' --env IMMICH_API_KEY='<IMMICH_API_KEY>' -- uvx immich-photo-manager
What are the best alternatives to Immich Photo Manager?
The closest alternatives to Immich Photo Manager are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Immich Photo Manager

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media