4,000+ servers built on vurb.ts
Vinkius
Unlock for AI Agents
CursorIDE
Immich (Google Photos Alternative) MCP Server

Bring Self Hosted
to Cursor

Learn how to connect Immich (Google Photos Alternative) to Cursor and start using 26 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.

MCP Inspector GDPR Free for Subscribers
Create AlbumCreate PersonCreate TagCreate UserDelete AlbumDelete AssetDelete PersonDelete TagDelete UserGet AlbumGet AssetGet PersonGet Server InfoGet TagGet UserList AlbumsList AssetsList PersonsList TagsList UsersUpdate AlbumUpdate AssetUpdate PersonUpdate TagUpdate UserUpload Asset

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Immich (Google Photos Alternative)

What is the 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.

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.

How it works

  1. Subscribe to this server
  2. Enter your Immich Instance URL and API Key
  3. Start managing your media library from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Self-Hosters — Manage your private cloud media library without leaving your workspace.
  • Content Creators — Quickly find, update, or upload assets for projects using natural language.
  • System Administrators — Monitor server health and manage user accounts across your Immich instance efficiently.

Built-in capabilities (26)

create_album

Create a new album

create_person

Create a new person record

create_tag

Create a new tag

create_user

Create a new user

delete_album

Delete an album

delete_asset

Delete an Immich asset

delete_person

Delete a person record

delete_tag

Delete a tag

delete_user

Delete a user

get_album

Get details for a specific album

get_asset

Get details for a specific Immich asset

get_person

Get details for a specific person

get_server_info

Get Immich server version and status information

get_tag

Get details for a specific tag

get_user

Get details for a specific user

list_albums

List all albums in Immich

list_assets

List all assets (photos/videos) in Immich

list_persons

List all recognized persons in Immich

list_tags

List all tags in Immich

list_users

List all users in Immich

update_album

Update an existing album

update_asset

g., isFavorite). Update an existing Immich asset

update_person

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

update_tag

Update an existing tag

update_user

Update an existing user

upload_asset

Upload a new photo or video to Immich

Why Cursor?

Cursor's Agent mode turns Immich (Google Photos Alternative) into an in-editor superpower. Ask Cursor to generate code using live data from Immich (Google Photos Alternative) and it fetches, processes, and writes. all in a single agentic loop. 26 tools appear alongside file editing and terminal access, creating a unified development environment grounded in real-time information.

  • Agent mode turns Cursor into an autonomous coding assistant that can read files, run commands, and call MCP tools without switching context

  • Cursor's Composer feature can generate entire files using real-time data fetched through MCP. no copy-pasting from external dashboards

  • MCP tools appear alongside built-in tools like file reading and terminal access, creating a unified agentic environment

  • VS Code extension compatibility means your existing workflow, keybindings, and extensions all work alongside MCP tools

See it in action

Immich (Google Photos Alternative) in Cursor

AI AgentVinkius
High Security·Kill Switch·Plug and Play
Why Vinkius

Immich (Google Photos Alternative) and 4,000+ other MCP servers. One platform. One governance layer.

Teams that connect Immich (Google Photos Alternative) to Cursor through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.

4,000+MCP Servers ready
<40msCold start
60%Token savings
Raw MCP
Vinkius
Server catalogFind and host yourself4,000+ managed
InfrastructureSelf-hostedSandboxed V8 isolates
Credential handlingPlaintext in configVault + runtime injection
Data loss preventionNoneConfigurable DLP policies
Kill switchNoneGlobal instant shutdown
Financial circuit breakersNonePer-server limits + alerts
Audit trailNoneEd25519 signed logs
SIEM log streamingNoneSplunk, Datadog, Webhook
HoneytokensNoneCanary alerts on leak
Custom domainsNot applicableDNS challenge verified
GDPR complianceManual effortAutomated purge + export
Enterprise Security

Why teams choose Vinkius for Immich (Google Photos Alternative) in Cursor

The Immich (Google Photos Alternative) 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. All 26 tools execute in hardened sandboxes optimized for native MCP execution.

Your AI agents in Cursor only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

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

The Vinkius Advantage

How Vinkius secures Immich (Google Photos Alternative) for Cursor

Every tool call from Cursor to the Immich (Google Photos Alternative) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

01

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

You can use the get_server_info tool. 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 tool 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 tool and provide a JSON payload with the albumName. You can also manage existing ones with list_albums and update_album.

04

What is Agent mode and why does it matter for MCP?

Agent mode is Cursor's autonomous execution mode where the AI can perform multi-step tasks: reading files, editing code, running terminal commands, and calling MCP tools. Without Agent mode, Cursor operates in a simpler ask-and-answer mode that doesn't support tool calling. Always ensure you're in Agent mode when working with MCP servers.

05

Where does Cursor store MCP configuration?

Cursor looks for MCP server configurations in a mcp.json file. You can configure servers at the project level (.cursor/mcp.json in your project root) or globally (~/.cursor/mcp.json). Project-level configs take precedence.

06

Can Cursor use MCP tools in inline edits?

No. MCP tools are only available in Agent mode through the chat panel. Inline completions and Tab suggestions do not trigger MCP tool calls. This is by design. tool calls require user visibility and approval.

07

How do I verify MCP tools are loaded?

Open Settings → Features → MCP and look for your server name. A green indicator means the server is connected. You can also check Agent mode's available tools by clicking the tools dropdown in the chat panel.

08

Tools not appearing in Cursor

Ensure you are in Agent mode (not Ask mode). MCP tools only work in Agent mode.

09

Server shows as disconnected

Check Settings → Features → MCP and verify the server status. Try clicking the refresh button.

Explore More MCP Servers

View all →