4,000+ servers built on vurb.ts
Vinkius

Immich (Google Photos Alternative) MCP Server for Claude CodeGive Claude Code instant access to 26 tools to Create Album, Create Person, Create Tag, and more

MCP Inspector GDPR Free for Subscribers

Claude Code is Anthropic's agentic CLI for terminal-first development. Add Immich (Google Photos Alternative) as an MCP server in one command and Claude Code will discover every tool at runtime. ideal for automation pipelines, CI/CD integration, and headless workflows via Vinkius.

Ask AI about this MCP Server for Claude Code

The Immich (Google Photos Alternative) MCP Server for Claude Code is a standout in the Image Video category — giving your AI agent 26 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Classic Setup·bash
# Your Vinkius token. get it at cloud.vinkius.com
claude mcp add immich-google-photos-alternative --transport http "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Immich (Google Photos Alternative) and 4,000+ MCP Servers from a single visual interface.

Vinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop Interface
Download Free Open SourceNo signup required
Immich (Google Photos Alternative)
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Immich (Google Photos Alternative) MCP Server

Connect your self-hosted Immich instance to any AI agent and take full control of your digital media library through natural conversation. Immich is the leading open-source alternative to Google Photos, and this MCP server allows you to interact with your assets, albums, and server settings seamlessly.

Claude Code registers Immich (Google Photos Alternative) as an MCP server in a single terminal command. Once connected, Claude Code discovers all 26 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where Immich (Google Photos Alternative) data drives decisions without human intervention.

What you can do

  • Asset Management — List, fetch, update, and delete photos or videos. You can even upload new media directly from your local environment.
  • Album Organization — Create and manage albums to keep your memories organized without manual clicking.
  • User & Person Administration — List and manage users, persons (faces), and tags to maintain a clean and searchable library.
  • Server Monitoring — Instantly check your Immich server version and status to ensure everything is running smoothly.

The Immich (Google Photos Alternative) MCP Server exposes 26 tools through the Vinkius. Connect it to Claude Code in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 26 Immich (Google Photos Alternative) tools available for Claude Code

When Claude Code connects to Immich (Google Photos Alternative) through Vinkius, your AI agent gets direct access to every tool listed below — spanning self-hosted, photo-management, media-library, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

create

Create album on Immich (Google Photos Alternative)

Create a new album

create

Create person on Immich (Google Photos Alternative)

Create a new person record

create

Create tag on Immich (Google Photos Alternative)

Create a new tag

create

Create user on Immich (Google Photos Alternative)

Create a new user

delete

Delete album on Immich (Google Photos Alternative)

Delete an album

delete

Delete asset on Immich (Google Photos Alternative)

Delete an Immich asset

delete

Delete person on Immich (Google Photos Alternative)

Delete a person record

delete

Delete tag on Immich (Google Photos Alternative)

Delete a tag

delete

Delete user on Immich (Google Photos Alternative)

Delete a user

get

Get album on Immich (Google Photos Alternative)

Get details for a specific album

get

Get asset on Immich (Google Photos Alternative)

Get details for a specific Immich asset

get

Get person on Immich (Google Photos Alternative)

Get details for a specific person

get

Get server info on Immich (Google Photos Alternative)

Get Immich server version and status information

get

Get tag on Immich (Google Photos Alternative)

Get details for a specific tag

get

Get user on Immich (Google Photos Alternative)

Get details for a specific user

list

List albums on Immich (Google Photos Alternative)

List all albums in Immich

list

List assets on Immich (Google Photos Alternative)

List all assets (photos/videos) in Immich

list

List persons on Immich (Google Photos Alternative)

List all recognized persons in Immich

list

List tags on Immich (Google Photos Alternative)

List all tags in Immich

list

List users on Immich (Google Photos Alternative)

List all users in Immich

update

Update album on Immich (Google Photos Alternative)

Update an existing album

update

Update asset on Immich (Google Photos Alternative)

g., isFavorite). Update an existing Immich asset

update

Update person on Immich (Google Photos Alternative)

Update an existing person (e.g., change name)

update

Update tag on Immich (Google Photos Alternative)

Update an existing tag

update

Update user on Immich (Google Photos Alternative)

Update an existing user

upload

Upload asset on Immich (Google Photos Alternative)

Upload a new photo or video to Immich

Connect Immich (Google Photos Alternative) to Claude Code via MCP

Follow these steps to wire Immich (Google Photos Alternative) into Claude Code. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
02

Add the MCP Server

Run the command above in your terminal
03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
04

Start using Immich (Google Photos Alternative)

Ask Claude: "Using Immich (Google Photos Alternative), show me...". 26 tools are ready

Why Use Claude Code with the Immich (Google Photos Alternative) MCP Server

Claude Code provides unique advantages when paired with Immich (Google Photos Alternative) through the Model Context Protocol.

01

Single-command setup: `claude mcp add` registers the server instantly. no config files to edit or applications to restart

02

Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks

03

Claude Code runs headlessly, enabling unattended batch processing using Immich (Google Photos Alternative) tools in cron jobs or deployment scripts

04

Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features

Immich (Google Photos Alternative) + Claude Code Use Cases

Practical scenarios where Claude Code combined with the Immich (Google Photos Alternative) MCP Server delivers measurable value.

01

CI/CD integration: embed Immich (Google Photos Alternative) tool calls in your deployment pipeline to validate configurations or fetch secrets before shipping

02

Headless batch processing: schedule Claude Code to query Immich (Google Photos Alternative) nightly and generate reports without human intervention

03

Shell scripting: pipe Immich (Google Photos Alternative) outputs into other CLI tools for data transformation, filtering, and aggregation

04

Infrastructure monitoring: run Claude Code in a cron job to query Immich (Google Photos Alternative) status endpoints and alert on anomalies

Example Prompts for Immich (Google Photos Alternative) in Claude Code

Ready-to-use prompts you can give your Claude Code agent to start working with Immich (Google Photos Alternative) immediately.

01

"List all my photos in Immich."

02

"Create a new album called 'Summer Vacation 2024'."

03

"Get the details for asset 550e8400-e29b-41d4-a716-446655440000."

Troubleshooting Immich (Google Photos Alternative) MCP Server with Claude Code

Common issues when connecting Immich (Google Photos Alternative) to Claude Code through Vinkius, and how to resolve them.

01

Command not found: claude

Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
02

Connection timeout

Check your internet connection and verify the Edge URL is reachable

Immich (Google Photos Alternative) + Claude Code FAQ

Common questions about integrating Immich (Google Photos Alternative) MCP Server with Claude Code.

01

How do I add an MCP server to Claude Code?

Run claude mcp add --transport http "" in your terminal. Claude Code registers the server and discovers all tools immediately.
02

Can Claude Code run MCP tools in headless mode?

Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
03

How do I list all connected MCP servers?

Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.

Explore More MCP Servers

View all →