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.
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
- PUTadd_assets_to_album
Add assets to an album.
- PUTadd_assets_to_albums
Add assets to albums.
- PUTadd_memory_assets
Add assets to a memory.
- PUTadd_shared_link_assets
Add assets to a shared link.
- PUTbulk_tag_assets
Tag assets.
- DELETEdelete_asset
Delete assets.
- GETget_asset
Retrieve an asset.
Statistic, 7 operations
- GETget_activity_statistics
Retrieve activity statistics.
- GETget_album_statistics
Retrieve album statistics.
- GETget_asset_statistics
Get asset statistics.
- GETget_library_statistics
Retrieve library statistics.
- GETget_person_statistics
Get person statistics.
- GETget_server_statistics
Get statistics.
- GETget_user_statistics
Retrieve user statistics.
User, 5 operations
- PUTadd_users_to_album
Share album with users.
- POSTcreate_user_admin
Create a user.
- DELETEdelete_user
Delete a user.
- GETget_admin_user
Retrieve a user.
- GETget_user
Retrieve a user.
Album, 4 operations
- POSTcreate_album
Create an album.
- DELETEdelete_album
Delete an album.
- GETget_album
Retrieve an album.
- GETlist_albums
List all albums.
Api key, 4 operations
- POSTcreate_api_key
Create an API key.
- DELETEdelete_api_key
Delete an API key.
- GETget_api_key
Retrieve an API key.
- GETlist_api_keys
List all API keys.
Notification, 4 operations
- POSTcreate_notification
Create a notification.
- DELETEdelete_notification
Delete notifications.
- DELETEdelete_notification_id
Delete a notification.
- GETget_notification
Get a notification.
People, 4 operations
- POSTcreate_person
Create a person.
- DELETEdelete_person
Delete people.
- DELETEdelete_person_id
Delete person.
- GETget_person
Get a person.
Request, 4 operations
- PUTcreate_cluster_group_request
Create a cluster group request.
- DELETEdelete_request
Decline a cluster group request.
- GETlist_cluster_group_requests
Retrieve cluster group requests.
- GETlist_cluster_group_requests_id
Retrieve the requests sent by a cluster group.
Stack, 4 operations
- POSTcreate_stack
Create a stack.
- DELETEdelete_stack
Delete stacks.
- DELETEdelete_stack_id
Delete a stack.
- GETget_stack
Retrieve a stack.
Activitie, 3 operations
- POSTcreate_activity
Create an activity.
- DELETEdelete_activity
Delete an activity.
- GETlist_activities
List all activities.
Librarie, 3 operations
- POSTcreate_library
Create a library.
- DELETEdelete_library
Delete a library.
- GETget_library
Retrieve a library.
Me, 3 operations
- GETget_api_key_me
Retrieve the current API key.
- GETget_shared_link_me
Retrieve current shared link.
- GETget_user_me
Get current user.
Memorie, 3 operations
- POSTcreate_memory
Create a memory.
- DELETEdelete_memory
Delete a memory.
- GETget_memory
Retrieve a memory.
Metadata, 3 operations
- DELETEdelete_asset_metadata
Delete asset metadata.
- DELETEdelete_asset_metadata_id
Delete asset metadata by key.
- GETget_metadata
Retrieve asset metadata by key.
Session, 3 operations
- POSTcreate_session
Create a session.
- DELETEdelete_session
Delete all sessions.
- DELETEdelete_session_id
Delete a session.
Stream, 3 operations
- POSTcreate_stream
Stream sync changes.
- DELETEend_session
End HLS streaming session.
- GETget_stream
Get HLS segment or init file.
Tag, 3 operations
- POSTcreate_tag
Create a tag.
- DELETEdelete_tag
Delete a tag.
- GETget_tag
Retrieve a tag.
Workflow, 3 operations
- POSTcreate_workflow
Create a workflow.
- DELETEdelete_workflow
Delete a workflow.
- GETget_workflow
Retrieve a workflow.
Ack, 2 operations
- DELETEdelete_ack
Delete acknowledgements.
- GETlist_ack
Retrieve acknowledgements.
Asset file, 2 operations
- DELETEdelete_asset_file
Delete an asset file.
- GETget_asset_file
Retrieve an asset file.
Bucket, 2 operations
- GETlist_bucket
Get time bucket.
- GETlist_buckets
Get time buckets.
Config, 2 operations
- GETlist_admin_config
Get the admin configuration.
- GETlist_config
Get the configuration with user visibility.
Database backup, 2 operations
- DELETEdelete_database_backup
Delete database backup.
- GETdownload_database_backup
Download database backup.
Duplicate, 2 operations
- DELETEdelete_duplicate
Delete duplicates.
- DELETEdelete_duplicate_id
Dismiss a duplicate group.
Face, 2 operations
- POSTcreate_face
Create a face.
- DELETEdelete_face
Delete a face.
Job, 2 operations
- POSTcreate_job
Create a manual job.
- DELETEempty_queue
Empty a queue.
License, 2 operations
- DELETEdelete_me_license
Delete user product key.
- DELETEdelete_server_license
Delete server product key.
Partner, 2 operations
- POSTcreate_partner
Create a partner.
- POSTcreate_partner_deprecated
Create a partner.
Profile image, 2 operations
- POSTcreate_profile_image
Create user profile image.
- DELETEdelete_profile_image
Delete user profile image.
Shared link, 2 operations
- POSTcreate_shared_link
Create a shared link.
- GETget_shared_link
Retrieve a shared link.
Statu, 2 operations
- GETget_auth_status
Retrieve auth status.
- GETget_maintenance_status
Get maintenance mode status.
About, 1 operation
- GETlist_about
Get server information.
Accept, 1 operation
- POSTaccept_cluster_group_request
Accept a cluster group request.
Admin onboarding, 1 operation
- GETlist_admin_onboarding
Retrieve admin onboarding.
Apk link, 1 operation
- GETlist_apk_links
Get APK links.
Archive, 1 operation
- POSTdownload_archive
Download asset archive.
Bulk upload check, 1 operation
- POSTcheck_bulk_upload
Check bulk upload.
Callback, 1 operation
- POSTfinish_oauth
Finish OAuth.
Change password, 1 operation
- POSTchange_password
Change password.
Citie, 1 operation
- GETlist_cities
Retrieve assets by city.
Copy, 1 operation
- PUTcopy_asset
Copy asset.
Default, 1 operation
- GETlist_admin_config_defaults
Get the system configuration defaults.
Detect install, 1 operation
- GETdetect_prior_install
Detect existing install.
Download, 1 operation
- GETdownload_asset_file
Download an asset file.
Edit, 1 operation
- PUTedit_asset
Apply edits to an existing asset.
Info, 1 operation
- POSTget_download_info
Retrieve download information.
Leave, 1 operation
- POSTleave_cluster_group
Leave a cluster group.
Link, 1 operation
- POSTlink_oauth_account
Link OAuth account.
Onboarding, 1 operation
- DELETEdelete_onboarding
Delete user onboarding.
Original, 1 operation
- GETdownload_asset
Download original asset.
Pin code, 1 operation
- PUTchange_pin_code
Change pin code.
Plugin, 1 operation
- GETget_plugin
Retrieve a plugin.
Queue, 1 operation
- GETget_queue
Retrieve a queue.
Report, 1 operation
- DELETEdelete_report
Delete integrity report item.
Summary, 1 operation
- GETget_integrity_summary
Get 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 mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}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.
Immich integration FAQ
- What can you do with the Immich integration?
- LiveContext exposes 264 operations on Immich, covering asset, statistic, user and album.
Popular integrations
Instagram (Instagram Login)Instagram API with Instagram Login (graph.instagram.com). Manage a Business/Creator Instagram account…
TelegramMessaging platform API for building bots and integrations. Send messages, manage chats and channels, handle…
YouTube Data APIGoogle's video platform API for accessing video, channel, playlist, and comment data
TikTokSocial media platform API for content creators and businesses. Access user info, manage videos, get…
Twitter / XSocial media platform API for posting, reading, and managing Twitter/X content. Post tweets, read timelines,…
GmailGoogle email service API for sending, receiving, and managing emails. Access messages, threads, labels,…
xAIAI API from xAI (Elon Musk's AI company) powering Grok models. Access state-of-the-art language models with…
LinkedInProfessional networking platform API for managing profiles, connections, and content. Share posts, manage…