Skip to content
Vinkius

Immich (Google Photos Alternative) Connector for AI agents.

26 live capabilities

Manage your self-hosted photo and video library with natural language.

Live agent request Immich (Google Photos Alternative) / Connector

Waiting for input…

AI Agent

Why people use Immich (Google Photos Alternative)

Immich for Private Photo Management

This Connector changes that by letting you just ask for what you want. You can tell your agent to find every photo from a specific trip and put them in a new folder. It handles the repetitive clicking for you, turning a ten-minute chore into a five-second request.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a voice-controlled interface for your private photo library.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 6,100+ Connectors

  1. Real-world use case 01

    Vacation sorting

    A user asks their agent to find all photos from a specific month and create a 'Summer 2023' album using create_album.

  2. Real-world use case 02

    Content hunting

    A creator asks their agent to list all videos tagged with 'B-roll' to quickly find footage for a new project.

  3. Real-world use case 03

    Privacy-first backup

    A user wants to upload 50 raw files from their camera to their self-hosted cloud without using a third-party app via upload_asset.

Complete set · 26capabilities

The complete Immich (Google Photos Alternative) capability set.

These are the exact actions your AI can choose when you ask it to work with Immich (Google Photos Alternative).

Capability set01 / 07

01—04

4 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 01 Capability

    Create album

    Create a new album. This lets you group your photos into specific collections quickly.

  2. 02 Capability

    Get asset

    Get details for a specific Immich asset. This lets your agent see the specific metadata for a photo or video.

  3. 03 Capability

    Get person

    Get details for a specific person. Use this to see how many photos are associated with a recognized face.

  4. 04 Capability

    Get tag

    Get details for a specific tag. This shows you the details and associated media for a specific label.

Capability set02 / 07

05—08

4 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 05 Capability

    Get user

    Get details for a specific user. This lets you check the account details of anyone with access to your library.

  2. 06 Capability

    List albums

    List all albums in Immich. This gives your agent a full overview of all your current photo collections.

  3. 07 Capability

    List assets

    List all assets (photos/videos) in Immich. This lets your agent see every piece of media in your library.

  4. 08 Capability

    List persons

    List all recognized persons in Immich. This shows every face the system has identified and grouped.

Capability set03 / 07

09—12

4 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 09 Capability

    List tags

    List all tags in Immich. This lets your agent see all the custom labels you've created for your media.

  2. 10 Capability

    Update album

    Update an existing album. Use this to rename or modify a photo collection without opening the web app.

  3. 11 Capability

    Update asset

    Update an existing Immich asset. This lets you change specific details like isFavorite on a photo or video.

  4. 12 Capability

    Update person

    Update an existing person. Use this to change the name of a recognized face in your library.

Capability set04 / 07

13—16

4 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 13 Capability

    Update tag

    Update an existing tag. This lets you modify the details of a custom label you've already created.

  2. 14 Capability

    Update user

    Update an existing user. Use this to change the account details or permissions for a specific person.

  3. 15 Capability

    Upload asset

    Upload a new photo or video to Immich. This lets your agent push new media from your local files into your library.

  4. 16 Capability

    Create person

    Create a new person record. Use this to add a new face to your library so the AI can recognize them.

Capability set05 / 07

17—20

4 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 17 Capability

    Create tag

    Create a new tag. This helps you organize your media with custom labels for easier searching.

  2. 18 Capability

    Create user

    Create a new user. Use this to give other people access to your self-hosted media library.

  3. 19 Capability

    Delete album

    Delete an album. This removes a collection of photos and videos from your library instantly.

  4. 20 Capability

    Delete asset

    Delete an Immich asset. Use this to remove specific photos or videos that you no longer want to keep.

Capability set06 / 07

21—23

3 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 21 Capability

    Delete person

    Delete a person record. Use this to remove a recognized face from your library's People section.

  2. 22 Capability

    Delete tag

    Delete a tag. This removes a custom label from your library when it's no longer needed.

  3. 23 Capability

    Delete user

    Delete a user. Use this to remove someone's access to your Immich instance.

Capability set07 / 07

24—26

3 capabilities in this set.

Part of 26 available through Immich (Google Photos Alternative).

  1. 24 Capability

    Get album

    Get details for a specific album. This pulls back all the information about a particular photo collection.

  2. 25 Capability

    List users

    List all users in Immich. This provides a full list of everyone who has access to your self-hosted photos.

  3. 26 Capability

    Get server info

    Get Immich server version and status information. This lets your agent check if your instance is running correctly.

Set up in minutes

One URL. Then ask Immich (Google Photos Alternative) to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Immich (Google Photos Alternative) from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it Immich (Google Photos Alternative), and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable Immich (Google Photos Alternative) for the conversation.

Where the request belongs

Work Immich can move forward.

Built around the request

This is for self-hosters who want to keep their photos off the cloud but need a better way to search them. It's perfect for people who value privacy and want to avoid big tech ecosystems.

01

Self-Hoster

The person who wants to manage a private cloud media library without leaving their workspace.

02

Content Creator

The creator who needs to quickly find, update, or upload assets for projects using natural language.

03

System Administrator

The admin who needs to monitor server health and manage user accounts across a shared Immich instance.

Bring your own AI

Change the model, client or framework. Keep Immich connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about Immich.

The practical details behind the request, access and result.

Can I use Immich MCP if I don't host it myself?

No, this Connector requires you to have a self-hosted Immich instance running. You'll need to provide your own instance URL and API key to connect it to your AI agent.

Does the Immich MCP give the AI access to my private photos?

The AI only interacts with your library when you give it a specific command. It doesn't browse your photos on its own; it only performs the actions you request, like finding a specific album or uploading a file.

How do I connect my Immich instance to my AI?

Once you subscribe, you'll just need to enter your Immich Instance URL and API Key into your AI client's settings. From there, your agent can start managing your media.

Can I create albums using just my voice?

Yes, if you use a voice-enabled AI client, you can simply speak your request. The Connector will handle the creation of the album and the organization of your photos automatically.

Is this a replacement for the Immich app?

It's not a replacement, but a different way to interact with your data. You can still use the Immich web app and mobile app, but this Connector lets you manage everything through a chat interface.

Can I manage multiple users with the Immich MCP?

Yes, you can use the Connector to list users, create new accounts, or delete old ones. It makes managing permissions for your shared media library much faster.

How can I check if my Immich server is online and see its version?

You can use the get_server_info capability. It will return the current version of the Immich server and its operational status.

Is it possible to upload a photo directly from my computer using this server?

Yes! Use the upload_asset capability by providing the absolute local file path. The AI will handle the multipart upload to your Immich instance.

Can I create a new album to organize my photos?

Absolutely. Use the create_album capability and provide a JSON payload with the albumName. You can also manage existing ones with list_albums and update_album.

One connection away

Give your agent a direct line to Immich.

Connect Immich once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available