How to Use the Immich (Google Photos Alternative) MCP in Claude

Q: Can I automate album creation in Immich (Google Photos Alternative) using Claude Desktop?

Yes. You just tell the agent to build an album and it uses createalbum to finish the task for you.

Q: Does Claude Desktop allow me to manage users in Immich (Google Photos Alternative)?

It does. You use the user-specific tools like createuser and listusers to handle access rights without a web browser.

Q: What happens to my EXIF data during an upload?

The uploadasset tool preserves your metadata. Your original file information stays intact throughout the transfer process.

Take back your photo library. Use the Immich (Google Photos Alternative) MCP server directly within Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Immich (Google Photos Alternative) MCP to Claude Desktop

Create your Vinkius account to connect Immich (Google Photos Alternative) to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Immich (Google Photos Alternative) with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage your library from Claude Desktop

Use `list_assets` to pull your entire collection into the chat context. You can see file details or scan your library without leaving the app. Organize specific memories using `create_album`. It lets you group photos instantly while you discuss them with your agent.

Handle users and metadata via MCP Server

Run `create_user` or `update_user` to manage family access permissions. You handle administrative tasks through simple natural language prompts. Keep your metadata clean with `update_tag` or `create_tag`. It ensures your self-hosted setup stays as organized as you want it.

Upload and verify assets

The `upload_asset` tool lets you push media directly from your local machine to your server. It works as a direct bridge for your files. Check your server health with `get_server_info`. You get immediate confirmation that your connection is active and your data is accessible.

Setup guide

Set up Immich (Google Photos Alternative) MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Immich (Google Photos Alternative) MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Immich (Google Photos Alternative) MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under immich-google-photos-alternative-mcp.

json

{
  "mcpServers": {
    "immich-google-photos-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Immich. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Immich (Google Photos Alternative) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Immich (Google Photos Alternative) MCP in Claude Desktop

Open your chat and ask your agent to show your images. It triggers the `list_assets` tool to display your library contents.

Yes. You just tell the agent to build an album and it uses `create_album` to finish the task for you.

It does. You use the user-specific tools like `create_user` and `list_users` to handle access rights without a web browser.

Your photos remain on your private hardware. This server only acts as a bridge for your AI client to execute commands on your instance.

The `upload_asset` tool preserves your metadata. Your original file information stays intact throughout the transfer process.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript

Mastra AI sdk-typescript

Start using the Immich (Google Photos Alternative) MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started