Integration

Immich integration

Immich is a self-hosted photo and video library. Browse and search assets, upload and download originals and thumbnails, manage albums and shared links, people and faces, tags, memories, stacks, trash and duplicates, run smart and metadata search, read timeline buckets, manage libraries, partners, users, API keys, sessions, notifications and server settings, and read server info, statistics and storage. The host is part of the credential because every install is its own deployment. Authentication is an API key sent in the x-api-key header.

Connect Immich How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Immich.Built from the 264 Immich tools below, on the connection you add once.

What you can do with Immich

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Asset, 7 operations

add_assets_to_albumAdd assets to albumPUTAdd assets to an album.
add_assets_to_albumsAdd assets to albumsPUTAdd assets to albums.
add_memory_assetsAdd memory assetsPUTAdd assets to a memory.
add_shared_link_assetsAdd shared link assetsPUTAdd assets to a shared link.
bulk_tag_assetsBulk tag assetsPUTTag assets.
delete_assetDelete assetDELETEDelete assets.
get_assetGet assetGETRetrieve an asset.

Statistic, 7 operations

get_activity_statisticsGet activity statisticsGETRetrieve activity statistics.
get_album_statisticsGet album statisticsGETRetrieve album statistics.
get_asset_statisticsGet asset statisticsGETGet asset statistics.
get_library_statisticsGet library statisticsGETRetrieve library statistics.
get_person_statisticsGet person statisticsGETGet person statistics.
get_server_statisticsGet server statisticsGETGet statistics.
get_user_statisticsGet user statisticsGETRetrieve user statistics.

User, 5 operations

add_users_to_albumAdd users to albumPUTShare album with users.
create_user_adminCreate user adminPOSTCreate a user.
delete_userDelete userDELETEDelete a user.
get_admin_userGet admin userGETRetrieve a user.
get_userGet userGETRetrieve a user.

Album, 4 operations

create_albumCreate albumPOSTCreate an album.
delete_albumDelete albumDELETEDelete an album.
get_albumGet albumGETRetrieve an album.
list_albumsList albumsGETList all albums.

Api key, 4 operations

create_api_keyCreate api keyPOSTCreate an API key.
delete_api_keyDelete api keyDELETEDelete an API key.
get_api_keyGet api keyGETRetrieve an API key.
list_api_keysList api keysGETList all API keys.

Notification, 4 operations

create_notificationCreate notificationPOSTCreate a notification.
delete_notificationDelete notificationDELETEDelete notifications.
delete_notification_idDelete notification idDELETEDelete a notification.
get_notificationGet notificationGETGet a notification.

People, 4 operations

create_personCreate personPOSTCreate a person.
delete_personDelete personDELETEDelete people.
delete_person_idDelete person idDELETEDelete person.
get_personGet personGETGet a person.

Request, 4 operations

create_cluster_group_requestCreate cluster group requestPUTCreate a cluster group request.
delete_requestDelete requestDELETEDecline a cluster group request.
list_cluster_group_requestsList cluster group requestsGETRetrieve cluster group requests.
list_cluster_group_requests_idList cluster group requests idGETRetrieve the requests sent by a cluster group.

Stack, 4 operations

create_stackCreate stackPOSTCreate a stack.
delete_stackDelete stackDELETEDelete stacks.
delete_stack_idDelete stack idDELETEDelete a stack.
get_stackGet stackGETRetrieve a stack.

Activitie, 3 operations

create_activityCreate activityPOSTCreate an activity.
delete_activityDelete activityDELETEDelete an activity.
list_activitiesList activitiesGETList all activities.

Librarie, 3 operations

create_libraryCreate libraryPOSTCreate a library.
delete_libraryDelete libraryDELETEDelete a library.
get_libraryGet libraryGETRetrieve a library.

Me, 3 operations

get_api_key_meGet api key meGETRetrieve the current API key.
get_shared_link_meGet shared link meGETRetrieve current shared link.
get_user_meGet user meGETGet current user.

Memorie, 3 operations

create_memoryCreate memoryPOSTCreate a memory.
delete_memoryDelete memoryDELETEDelete a memory.
get_memoryGet memoryGETRetrieve a memory.

Metadata, 3 operations

delete_asset_metadataDelete asset metadataDELETEDelete asset metadata.
delete_asset_metadata_idDelete asset metadata idDELETEDelete asset metadata by key.
get_metadataGet metadataGETRetrieve asset metadata by key.

Session, 3 operations

create_sessionCreate sessionPOSTCreate a session.
delete_sessionDelete sessionDELETEDelete all sessions.
delete_session_idDelete session idDELETEDelete a session.

Stream, 3 operations

create_streamCreate streamPOSTStream sync changes.
end_sessionEnd sessionDELETEEnd HLS streaming session.
get_streamGet streamGETGet HLS segment or init file.

Tag, 3 operations

create_tagCreate tagPOSTCreate a tag.
delete_tagDelete tagDELETEDelete a tag.
get_tagGet tagGETRetrieve a tag.

Workflow, 3 operations

create_workflowCreate workflowPOSTCreate a workflow.
delete_workflowDelete workflowDELETEDelete a workflow.
get_workflowGet workflowGETRetrieve a workflow.

Ack, 2 operations

delete_ackDelete ackDELETEDelete acknowledgements.
list_ackList ackGETRetrieve acknowledgements.

Asset file, 2 operations

delete_asset_fileDelete asset fileDELETEDelete an asset file.
get_asset_fileGet asset fileGETRetrieve an asset file.

Bucket, 2 operations

list_bucketList bucketGETGet time bucket.
list_bucketsList bucketsGETGet time buckets.

Config, 2 operations

list_admin_configList admin configGETGet the admin configuration.
list_configList configGETGet the configuration with user visibility.

Database backup, 2 operations

delete_database_backupDelete database backupDELETEDelete database backup.
download_database_backupDownload database backupGETDownload database backup.

Duplicate, 2 operations

delete_duplicateDelete duplicateDELETEDelete duplicates.
delete_duplicate_idDelete duplicate idDELETEDismiss a duplicate group.

Face, 2 operations

create_faceCreate facePOSTCreate a face.
delete_faceDelete faceDELETEDelete a face.

Job, 2 operations

create_jobCreate jobPOSTCreate a manual job.
empty_queueEmpty queueDELETEEmpty a queue.

License, 2 operations

delete_me_licenseDelete me licenseDELETEDelete user product key.
delete_server_licenseDelete server licenseDELETEDelete server product key.

Partner, 2 operations

create_partnerCreate partnerPOSTCreate a partner.
create_partner_deprecatedCreate partner deprecatedPOSTCreate a partner.

Profile image, 2 operations

create_profile_imageCreate profile imagePOSTCreate user profile image.
delete_profile_imageDelete profile imageDELETEDelete user profile image.

Shared link, 2 operations

create_shared_linkCreate shared linkPOSTCreate a shared link.
get_shared_linkGet shared linkGETRetrieve a shared link.

Statu, 2 operations

get_auth_statusGet auth statusGETRetrieve auth status.
get_maintenance_statusGet maintenance statusGETGet maintenance mode status.

About, 1 operation

list_aboutList aboutGETGet server information.

Accept, 1 operation

accept_cluster_group_requestAccept cluster group requestPOSTAccept a cluster group request.

Admin onboarding, 1 operation

list_admin_onboardingList admin onboardingGETRetrieve admin onboarding.

Apk link, 1 operation

list_apk_linksList apk linksGETGet APK links.

Archive, 1 operation

download_archiveDownload archivePOSTDownload asset archive.

Bulk upload check, 1 operation

check_bulk_uploadCheck bulk uploadPOSTCheck bulk upload.

Callback, 1 operation

finish_oauthFinish oauthPOSTFinish OAuth.

Change password, 1 operation

change_passwordChange passwordPOSTChange password.

Citie, 1 operation

list_citiesList citiesGETRetrieve assets by city.

Copy, 1 operation

copy_assetCopy assetPUTCopy asset.

Default, 1 operation

list_admin_config_defaultsList admin config defaultsGETGet the system configuration defaults.

Detect install, 1 operation

detect_prior_installDetect prior installGETDetect existing install.

Download, 1 operation

download_asset_fileDownload asset fileGETDownload an asset file.

Edit, 1 operation

edit_assetEdit assetPUTApply edits to an existing asset.

Info, 1 operation

get_download_infoGet download infoPOSTRetrieve download information.

Leave, 1 operation

leave_cluster_groupLeave cluster groupPOSTLeave a cluster group.

Link, 1 operation

link_oauth_accountLink oauth accountPOSTLink OAuth account.

Onboarding, 1 operation

delete_onboardingDelete onboardingDELETEDelete user onboarding.

Original, 1 operation

download_assetDownload assetGETDownload original asset.

Pin code, 1 operation

change_pin_codeChange pin codePUTChange pin code.

Plugin, 1 operation

get_pluginGet pluginGETRetrieve a plugin.

Queue, 1 operation

get_queueGet queueGETRetrieve a queue.

Report, 1 operation

delete_reportDelete reportDELETEDelete integrity report item.

Summary, 1 operation

get_integrity_summaryGet integrity summaryGETGet integrity report summary.

Showing the first 120 of 264 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Immich from Claude Code, Cursor or Codex

Connect Immich in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Immich operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Immich

Create your workspace
Sign up free. Nothing to install.
Connect Immich once
Add your Immich connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.