Immich (Google Photos Alternative)

Immich (Google Photos Alternative) MCP Connector for Claude

A+

Manage your self-hosted Immich photo and video library — list assets, organize albums, and handle user administration via AI.

26 tools Official Updated Oct 1, 2026 Official Vinkius Partner

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.
self-hostedphoto-managementmedia-libraryasset-managementbackupdigital-assets

26 tools expose this connector's capabilities to your AI agent.

get_person

Provide the person’s UUID as the required input. Get details for a specific person

get_user

Pass the user UUID to identify the target user. Get details for a specific user

list_assets

List all assets (photos/videos) in Immich

get_server_info

Get Immich server version and status information

update_asset

g., isFavorite). Update an existing Immich asset

upload_asset

Upload a new photo or video to Immich

create_album

Supply a JSON payload containing the album details. Create a new album

create_person

Supply a JSON payload with the person’s details. Create a new person record

create_user

Supply a JSON payload with the required user details. Create a new user

delete_album

Use the album UUID to identify the target album. Delete an album

delete_tag

Provide the UUID of the tag to be deleted. Delete a tag

get_tag

Pass the tag’s UUID to fetch the information. Get details for a specific tag

list_albums

Do not specify any parameters. List all albums in Immich

list_persons

Use this to find a person’s unique identifier. List all recognized persons in Immich

list_tags

Use this to find a tag’s unique identifier. List all tags in Immich

list_users

No authentication is required for this query. List all users in Immich

delete_person

Use the person’s UUID to identify the record. Delete a person record

delete_user

Provide the UUID of the user to be deleted. Delete a user

get_album

Provide the album UUID as the required ID. Get details for a specific album

get_asset

Get details for a specific Immich asset

create_tag

Supply a JSON payload containing the tag details. Create a new tag

delete_asset

Delete an Immich asset

update_album

Supply both the album ID and the data payload. Update an existing album

update_person

Supply the person’s UUID and the data payload. Update an existing person (e.g., change name)

update_tag

Supply the tag’s UUID and the data payload. Update an existing tag

update_user

Provide the user ID and the data payload. Update an existing user

See how to talk to your AI agent using Immich (Google Photos Alternative).

List all my photos in Immich.

I've retrieved your assets. You have 150 photos and videos available. Would you like to see the details of the most recent one?

Create a new album called 'Summer Vacation 2024'.

The album 'Summer Vacation 2024' has been successfully created with UUID: 8f2d... You can now start adding assets to it.

Get the details for asset 550e8400-e29b-41d4-a716-446655440000.

Inspecting asset... This is a JPEG image taken on 2023-08-15. It is currently marked as a favorite and is part of the 'Travel' album.

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

Related Connectors