• USER DATA
  • PERSON DATA
  • DATABASE
  • HUMAN

How to administer users and people with your AI

Connect your Immich instance to your AI client to handle account management and facial recognition data through chat.

Ask AI about this page

Short answer

How can I manage Immich users and people using AI?

You can add, remove, or update user accounts and person recognition records by asking your AI client to perform specific actions. This gives you a way to organize your photo library and access control without opening the Immich dashboard. You'll see the specific outcomes below.

Where your changes land.

Direct database updates.

Every command you send translates to a direct update in your Immich instance.

USER DATA

Account management

Your AI modifies user profiles and permissions. You get a way to add or remove people from your instance.

PERSON DATA

Face recognition control

Manage how Immich identifies people in your photos. You can create or fix person records through chat.

DATABASE

Instant updates

Changes happen in real time. Your Immich instance reflects the new users or person identities immediately.

HUMAN

Manual review needed

The AI handles the data entry, but you still need to check the photo library to ensure facial recognition is accurate.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat interface and the Immich API.

  1. Identify targets

    The AI looks up existing users or people in your library to make sure it is acting on the right account or identity.

    list_userslist_persons

  2. Modify accounts

    Once the target is identified, the AI creates new users or updates existing profile information.

    create_userupdate_user

  3. Manage identities

    The AI handles the person recognition records, allowing you to add new people or update their names.

    create_personupdate_person

  4. Clean up

    If you need to remove an account or a person record, the AI executes the deletion in your instance.

    delete_userdelete_person

Try it

Copy these to start.

Use these prompts to trigger actions in Immich.

Starting points

These are templates. Swap out the names in brackets with your actual Immich user names or person identities.

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"
    }
  }
}
Copy into chat04

  • List all the users currently in my Immich instance.

  • Create a new user named [Name] for my library.

  • Update the person record for [Name] to change their name.

  • Delete the user account for [Name].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Immich once, then ask.

Just provide your Immich credentials through the Vinkius setup. Your login stays encrypted, and you can immediately start managing your library with any MCP-compatible client.

Connect Immich to your AI

FAQ

Common questions

  • 01

    Can the AI delete my actual photos?

    No. The tools only allow for managing user accounts and person recognition records.

  • 02

    Can I use this to change my password?

    No. There are no tools available to modify user passwords.

  • 03

    How do I see who is in my library?

    You can ask your AI to list all users or list all recognized persons.

  • 04

    Will the AI automatically fix misidentified faces?

    No. The AI can update person records, but you must tell it which person to update.

  • 05

    Does the AI need my Immich admin password?

    You provide your credentials to Vinkius to establish the connection, but your AI client only interacts with the tools provided by the MCP.

  • More questions about Immich? The Connector page answers them. See everything the Immich Connector can do

Connect Immich to Claude, Cursor, ChatGPT & more