Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Immich with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage your self-hosted Immich photo and video library. list assets, organize albums, and handle user administration via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 26 capabilities

The complete Immich capability set.

These are the exact actions your AI can choose when you ask it to work with Immich.

Capability set01 / 07

01-04

4 capabilities in this set.

Part of 26 available through Immich.

  1. 01

    Create album

    Create a new album

  2. 02

    Get asset

    Get details for a specific Immich asset

  3. 03

    Get tag

    Get details for a specific tag

  4. 04

    Get user

    Get details for a specific user

Capability set02 / 07

05-08

4 capabilities in this set.

Part of 26 available through Immich.

  1. 05

    List albums

    List all albums in Immich

  2. 06

    List persons

    List all recognized persons in Immich

  3. 07

    List tags

    List all tags in Immich

  4. 08

    Update asset

    G., isFavorite). Update an existing Immich asset

Capability set03 / 07

09-12

4 capabilities in this set.

Part of 26 available through Immich.

  1. 09

    Update tag

    Update an existing tag

  2. 10

    Upload asset

    Upload a new photo or video to Immich

  3. 11

    Create tag

    Create a new tag

  4. 12

    Create user

    Create a new user

Capability set04 / 07

13-16

4 capabilities in this set.

Part of 26 available through Immich.

  1. 13

    Delete album

    Delete an album

  2. 14

    Delete person

    Delete a person record

  3. 15

    Delete tag

    Delete a tag

  4. 16

    Delete user

    Delete a user

Capability set05 / 07

17-20

4 capabilities in this set.

Part of 26 available through Immich.

  1. 17

    Get album

    Get details for a specific album

  2. 18

    List users

    List all users in Immich

  3. 19

    Create person

    Create a new person record

  4. 20

    Delete asset

    Delete an Immich asset

Capability set06 / 07

21-23

3 capabilities in this set.

Part of 26 available through Immich.

  1. 21

    Get person

    Get details for a specific person

  2. 22

    Get server info

    Get Immich server version and status information

  3. 23

    List assets

    List all assets (photos/videos) in Immich

Capability set07 / 07

24-26

3 capabilities in this set.

Part of 26 available through Immich.

  1. 24

    Update album

    Update an existing album

  2. 25

    Update person

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

  3. 26

    Update user

    Update an existing user

Observed, not estimated

979ms average. Fast in production.

Immich is checked daily against the live service.

Daily averagePeak 1241ms
Aug 20Today
Fastest day
842ms
Slowest day
1241ms
14-day trend
Slowing+37%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 26 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Immich, so you can see the experience inside your AI.

It does not authenticate your account with Immich. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Immich Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Immich capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "immich-google-photos-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Immich owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Image Video

Suggestions