# Immich MCP > Immich MCP connects your self-hosted media library to any AI agent, giving you full control over photos and videos through natural conversation. You can list assets, create albums, manage users, or check the server status without opening a single tab. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** self-hosted, photo-management, media-library, asset-management, backup, digital-assets ## Description Take complete command of your private photo and video archive using this MCP. It lets your AI client interact directly with every part of your self-hosted Immich instance—everything from individual photos to complex user structures. Instead of digging through dashboards, you talk to the library itself. Need a specific image? Just ask for it. Want to group pictures taken last summer? Tell your agent to create an album and populate it automatically. You can organize assets by listing every person recognized in the images or creating new tags across entire collections. When you connect this MCP via Vinkius, you bring that massive catalog of media management tools directly into your chat window, letting you manage all your data without leaving your workspace. ## Tools ### create_album Creates a brand new album within your Immich photo library. ### create_person Adds a new identity record for a person found in the photos. ### create_tag Establishes a new descriptive tag you can apply to various assets. ### create_user Sets up an account for a new user within the Immich system. ### delete_album Removes an entire album and all its associated contents from the library. ### delete_asset Permanently deletes a specific photo or video file from the collection. ### delete_person Removes an identity record for a person, cleaning up obsolete data. ### delete_tag Deactivates or removes a tag that was previously used across the library. ### delete_user Removes an existing user account from the Immich system. ### get_album Retrieves all details about a specific, named album. ### get_asset Fetches metadata and information for one unique photo or video file. ### get_person Retrieves the profile details for a recognized person in your photos. ### get_tag Gets all information about an existing tag, including its usage count. ### get_user Retrieves the current profile and permissions for a specific user account. ### list_albums Generates a comprehensive list of every album currently stored in Immich. ### list_assets Outputs a list containing the titles and IDs of all photos and videos available. ### list_persons Returns a full directory listing of every person face recognized by the system. ### list_tags Outputs all tags that have been created and used across your entire media collection. ### list_users Provides a complete list of every user account connected to Immich. ### get_server_info Checks the current operating version and overall status of the Immich instance. ### update_album Modifies the details or contents of an existing album without deleting it. ### update_asset Changes metadata, like marking as a favorite, on an already uploaded photo or video. ### update_person Modifies a person's record, such as correcting their name or adding context. ### update_tag Changes the definition or scope of an existing tag across the library. ### update_user Modifies a user's profile details or permissions level. ### upload_asset Transfers and adds a new photo or video file directly into the Immich library from your local machine. ## Prompt Examples **Prompt:** ``` List all my photos in Immich. ``` **Response:** ``` I've retrieved your assets. You have 150 photos and videos available. Would you like to see the details of the most recent one? ``` **Prompt:** ``` Create a new album called 'Summer Vacation 2024'. ``` **Response:** ``` The album 'Summer Vacation 2024' has been successfully created with UUID: 8f2d... You can now start adding assets to it. ``` **Prompt:** ``` Get the details for asset 550e8400-e29b-41d4-a716-446655440000. ``` **Response:** ``` 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. ``` ## Capabilities ### Manage Assets and Media You can list all photos or videos in the library, fetch specific details about an asset, update existing media records, delete old files, or even upload new media directly. ### Organize Albums and Collections Create brand new albums, view detailed information for any existing album, update its contents, or remove it entirely when the memories are archived. ### Handle People and Tags List all recognized people in your photos, get details on a specific person's profile, create new identity records, delete old ones, or manage custom tags across the entire library. ### Manage Users and Accounts View who has access to the system by listing all users, creating new accounts, updating user profiles, or removing user access completely. ### Monitor System Health Get instant information on your Immich server's current version and operating status without logging into the admin panel. ## Use Cases ### Auditing old event photos A corporate historian needs to prove who was at the 2019 conference. They ask their agent: 'List all people from the 2019 conference and get details for John Smith.' The MCP uses list_persons, then gets_person, delivering a structured report instead of forcing them into the web UI. ### Cleaning up user data An HR manager needs to decommission an old account. They tell their agent: 'Deactivate User Jane Doe.' The MCP runs delete_user, then confirms that all associated tags and albums are managed or archived. ### Batch uploading new content A photographer just finished a shoot and has 500 RAW files. Instead of using the standard upload process, they instruct their agent to 'Upload these 500 assets.' The MCP runs upload_asset for all files, getting them into the system instantly. ### Creating a retrospective gallery The family wants to compile photos from multiple years. They ask: 'Create an album called Family Reunion 2025 and add any assets tagged with 'Grandma'.' The MCP runs create_album, then uses list_tags/get_tag logic to populate it. ## Benefits - Stop manually sorting photos. Use list_persons and get_person to query the library by face recognition, instantly finding specific memories without keyword guessing. - Never lose track of a file again. You can use list_assets or list_albums to see your entire inventory at a glance, then pinpoint details with get_asset when you need it. - Maintain clean user data effortlessly. When an employee leaves, instead of manually finding and deleting records, run delete_user and delete_person to scrub the account entirely. - Keep your collections organized without clicking through menus. Simply ask your AI client to create_album a new grouping based on dates or events, then populate it automatically. - Speed up content ingestion. Instead of zipping files and uploading them via the UI, use upload_asset to push large batches of media directly from your local folder into Immich. - Monitor system health quickly. Use get_server_info to instantly verify that everything is running smoothly before a major project rollout. ## How It Works The bottom line is that you treat your entire complex, self-hosted photo archive like a simple conversation with an expert assistant. 1. Subscribe to this MCP and enter your specific Immich Instance URL along with a valid API Key. 2. Your AI agent uses those credentials to connect directly to your private media library's backend. 3. You simply type natural language requests (e.g., 'Create an album for the 2024 trip') and the MCP executes the required actions. ## Frequently Asked Questions **How do I use Immich MCP to upload photos?** You use the upload_asset tool. Simply ask your agent to run this tool and specify the local folder path or file names you want added to your library. **Can I list all users with Immich MCP?** Yes, use the list_users tool. This provides a complete directory of every account currently connected to your Immich instance for quick auditing or status checks. **What if I need to correct someone's name? Should I use update_person?** Yes, you run the update_person tool. This allows you to modify details like a person's recognized name or add descriptive context without deleting their profile entirely. **How do I check if my Immich server is running okay?** You use get_server_info. This single tool gives you the current operational status and version number, letting you verify system health instantly. **Does Immich MCP let me delete assets? Is it safe?** Yes, the delete_asset tool permanently removes files. Since this is a powerful action, your AI client will prompt for confirmation before running any deletion command to prevent accidental loss. **Can I list and update tags across my library?** Absolutely. You can use list_tags to see what exists, then use get_tag to check details, and finally run update_tag if you need to change the tag's scope or definition.