Immich (Google Photos Alternative) Connector for AI agents.
26 live capabilities
Manage your self-hosted photo and video library with natural language.
Waiting for input…
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.
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
- 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.
- 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.
- 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).
01—04
4 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 01 Capability
Create album
Create a new album. This lets you group your photos into specific collections quickly.
- 02 Capability
Get asset
Get details for a specific Immich asset. This lets your agent see the specific metadata for a photo or video.
- 03 Capability
Get person
Get details for a specific person. Use this to see how many photos are associated with a recognized face.
- 04 Capability
Get tag
Get details for a specific tag. This shows you the details and associated media for a specific label.
05—08
4 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 05 Capability
Get user
Get details for a specific user. This lets you check the account details of anyone with access to your library.
- 06 Capability
List albums
List all albums in Immich. This gives your agent a full overview of all your current photo collections.
- 07 Capability
List assets
List all assets (photos/videos) in Immich. This lets your agent see every piece of media in your library.
- 08 Capability
List persons
List all recognized persons in Immich. This shows every face the system has identified and grouped.
09—12
4 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 09 Capability
List tags
List all tags in Immich. This lets your agent see all the custom labels you've created for your media.
- 10 Capability
Update album
Update an existing album. Use this to rename or modify a photo collection without opening the web app.
- 11 Capability
Update asset
Update an existing Immich asset. This lets you change specific details like isFavorite on a photo or video.
- 12 Capability
Update person
Update an existing person. Use this to change the name of a recognized face in your library.
13—16
4 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 13 Capability
Update tag
Update an existing tag. This lets you modify the details of a custom label you've already created.
- 14 Capability
Update user
Update an existing user. Use this to change the account details or permissions for a specific person.
- 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.
- 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.
17—20
4 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 17 Capability
Create tag
Create a new tag. This helps you organize your media with custom labels for easier searching.
- 18 Capability
Create user
Create a new user. Use this to give other people access to your self-hosted media library.
- 19 Capability
Delete album
Delete an album. This removes a collection of photos and videos from your library instantly.
- 20 Capability
Delete asset
Delete an Immich asset. Use this to remove specific photos or videos that you no longer want to keep.
21—23
3 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 21 Capability
Delete person
Delete a person record. Use this to remove a recognized face from your library's People section.
- 22 Capability
Delete tag
Delete a tag. This removes a custom label from your library when it's no longer needed.
- 23 Capability
Delete user
Delete a user. Use this to remove someone's access to your Immich instance.
24—26
3 capabilities in this set.
Part of 26 available through Immich (Google Photos Alternative).
- 24 Capability
Get album
Get details for a specific album. This pulls back all the information about a particular photo collection.
- 25 Capability
List users
List all users in Immich. This provides a full list of everyone who has access to your self-hosted photos.
- 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 previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Immich (Google Photos Alternative), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Immich (Google Photos Alternative) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Immich (Google Photos Alternative) URL.
- Step 03
Save and start
Save the connection and enable Immich (Google Photos Alternative) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"immich-google-photos-alternative": {
"url": "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Immich (Google Photos Alternative)
Open Agent mode in chat and ask: "Using Immich (Google Photos Alternative), help me...". 26 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"immich-google-photos-alternative": {
"url": "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Immich (Google Photos Alternative)
Ask Copilot: "Using Immich (Google Photos Alternative), help me...". 26 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"immich-google-photos-alternative": {
"url": "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Immich (Google Photos Alternative)
Open Cascade and ask: "Using Immich (Google Photos Alternative), help me...". 26 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"immich-google-photos-alternative": {
"url": "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Immich (Google Photos Alternative)
Ask Cline: "Using Immich (Google Photos Alternative), help me...". 26 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add immich-google-photos-alternative --transport http "https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Immich (Google Photos Alternative)
Ask Claude: "Using Immich (Google Photos Alternative), show me...". 26 tools are ready
Where the request belongs
Work Immich can move forward.
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.
Self-Hoster
The person who wants to manage a private cloud media library without leaving their workspace.
Content Creator
The creator who needs to quickly find, update, or upload assets for projects using natural language.
System Administrator
The admin who needs to monitor server health and manage user accounts across a shared Immich instance.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPhotoPrism
Search, browse, and manage your PhotoPrism media library. find photos by metadata, retrieve thumbnails, and stream videos via AI.
Cincopa
Manage video and media galleries via Cincopa. track assets, trigger uploads, and monitor engagement directly from any AI agent.
ImageKit (Media Optimization & DAM)
Manage and optimize media via ImageKit. list files, purge CDN cache, and audit image metadata.
Imgur
Manage Imgur content. upload images, organize albums, and browse the gallery directly from your AI agent.
Pics.io
Organize and share creative assets with a digital asset management platform that tags, searches, and delivers files fast.
Unsplash
Access millions of high-resolution images. search photos, manage collections, and track download statistics directly from any AI agent.
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