# Immich (Google Photos Alternative) MCP for AI Agents AI Agent Connect

> Immich (Google Photos Alternative) MCP lets you talk to your self-hosted photo and video library. You can ask your AI agent to find specific memories, organize them into albums, or manage your user accounts without ever opening a browser. It's the bridge between your private cloud and your AI agent.

## Overview
- **Category:** image-video
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Hjmeuwnl6jUxJOg58qEVKvrefjEyVPlxIMdCkpL9/ai-agent-connect
- **Tags:** self-hosted, photo-management, media-library, asset-management, backup, digital-assets

## Description

Imagine having a personal assistant who knows exactly where every photo of your kids, your dog, or that vacation in Italy is stored. This Connector turns your Immich instance into a searchable, actionable database for your AI agent. Instead of digging through folders or scrolling endlessly through a timeline, you just tell your agent what you need. You can have it pull up all the videos from last summer, group them into a new collection, and even upload a batch of new shots from your local storage directly into the right spot. It handles the heavy lifting of metadata and organization so you don't have to deal with the tedious manual clicking. Since you're using the Vinkius catalog to connect these tools, you get a reliable way to manage your private media without giving a big tech company access to your life. You're in control of the data, and your AI agent provides the interface to navigate it. It works by pulling your library's information into your chat window, letting you perform complex organization tasks with a single sentence. Whether you're cleaning up old tags or checking your server status, it makes managing a private cloud feel like a conversation rather than a chore.

## Tools

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## Prompt Examples

**Prompt:** 
```
Find all my photos from last summer and put them in an album called 'Summer 2023'.
```

**Response:** 
```
I've scanned your library for photos from June through August 2023. I found 142 assets. 

**Action Taken:**
- Created album: **Summer 2023**
- Moved 142 photos into the new album.

Would you like me to do anything else with these photos?
```

**Prompt:** 
```
Who are the people recognized in my library?
```

**Response:** 
```
Your library currently has **4 recognized people**: 

| Name | Total Photos |
| :--- | :--- |
| John Doe | 450 |
| Jane Smith | 320 |
| Sarah Connor | 120 |
| Unknown | 45 |

Would you like to update the name for any of these?
```

**Prompt:** 
```
Upload this new video from my desktop to my Immich library.
```

**Response:** 
```
I'm starting the upload of your video file to your Immich instance now.

**Upload Progress:**
- **File:** vacation_clip.mp4
- **Status:** Uploading...
- **Size:** 450MB

I'll let you know as soon as it's finished and indexed.
```

## Capabilities

### Create albums
Group your photos into specific collections using natural language.

### Upload new media
Push photos and videos from your local machine into your library.

### Manage user accounts
Add or remove people who have access to your media.

### Organize face tags
Edit or create records for recognized people in your library.

### Check server status
Get a quick look at your instance version and health.

## Use Cases

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

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

### 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.

### Admin cleanup
A sysadmin needs to delete three old test accounts and update the permissions on the main family album using delete_user.

## Benefits

- Stop manual sorting: Use create_album and update_album to let your agent handle the heavy lifting of organizing your memories.
- Private media control: Keep your photos on your own hardware while still using the power of an AI agent to find what you need.
- Faster asset retrieval: Use list_assets and get_asset to pull up specific photos instantly without scrolling through a timeline.
- Simple user management: Use create_user, update_user, and delete_user to handle permissions for everyone with access to your library.
- Automated face tagging: Use create_person, update_person, and delete_person to keep your People section accurate and searchable.
- Easy metadata updates: Use update_asset to change favorites or other details on your media without opening the web interface.

## How It Works

The bottom line is you get a voice-controlled interface for your private photo library.

1. Subscribe to the Immich MCP on Vinkius.
2. Provide your instance URL and API key in your AI client's settings.
3. Ask your agent to find, organize, or upload photos.

## Frequently Asked Questions

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