• TAGGING
  • CLEANUP
  • SEARCH
  • REVIEW

How to manage media metadata and tags with your AI

Connect your AI to Immich to handle the tedious work of photo organization. Once connected, your agent can read your library and update details for you.

Ask AI about this page

Short answer

How can I use AI to organize my Immich library?

Your agent uses specific tools to scan your assets, find existing tags, and apply new ones. You get a searchable, organized library without manual entry. Here is how it works.

Organized media outcomes.

Where your library lands.

The AI moves your data into these states.

TAGGING

Auto-labeled assets

The agent applies specific labels to your photos. You'll find everything under the right categories immediately.

CLEANUP

Removed junk tags

The AI identifies and deletes redundant tags. This keeps your metadata from getting cluttered.

SEARCH

Findable media

By updating asset details, the agent makes sure your files show up when you search for specific subjects.

REVIEW

Human oversight

You decide which tags are accurate. The AI suggests or applies changes, but you maintain final control over the library.

The workflow

What your AI does when <the thing arrives>.

The agent follows a logical loop to clean up your media.

  1. Scan the library

    The agent looks through your Immich collection to see what you have and what tags already exist.

    list_assetslist_tags

  2. Identify targets

    It checks the specific details of a photo to see if it needs new information.

    get_tag

  3. Apply updates

    The agent writes new labels or modifies existing ones to match your instructions.

    create_tagupdate_tag

  4. Clean up

    It removes incorrect or duplicate tags to keep the metadata lean.

    delete_tagupdate_asset

Try it

Copy these to start.

Use these prompts to kick off the organization process.

Starting points

These are opening lines. Swap out the bracketed text for your specific needs, like a date or a subject.

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 my assets from last summer and tell me what tags they have.

  • Find all photos tagged with 'vacation' and add a 'beach' tag to them.

  • Look through my recent uploads and create a new tag called 'family' for any photos containing people.

  • Check if there are any duplicate tags in my library and let me know.

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

Start here

Connect Immich once, then ask.

Just link your Immich instance to Vinkius. Your credentials stay encrypted, and you can immediately start chatting with your media library.

Connect Immich to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete my actual photos?

    No. The tools only allow the AI to manage metadata and tags. Your files remain untouched.

  • 02

    Will the AI change my folder structure?

    No. This MCP is strictly for managing tags and asset metadata, not moving files or changing directories.

  • 03

    How does the AI know what to tag?

    The AI uses the information it reads from your assets and follows the specific instructions you give it in your prompts.

  • 04

    Can I undo a tag change?

    Yes. Since the AI uses standard tag management tools, you can simply ask it to remove or revert a tag.

  • 05

    Does the AI need to see my private photos?

    Yes. To manage tags and metadata, the AI must be able to read the asset details provided by Immich.

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

Connect Immich to Claude, Cursor, ChatGPT & more