# immichctrl MCP server

> Lets AI clients search, curate, and manage self-hosted Immich photo and video libraries through a typed control surface.

- Repository: https://github.com/lidless-labs/immichctrl
- Page: https://hostedmcp.org/servers/lidless-labs/immichctrl
- Transport: —
- Stars: 6
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `IMMICH_ALLOW_WRITES` | no | no |  |
| `IMMICH_API_KEY` | no | no |  |
| `IMMICH_BASE_URL` | no | no |  |

## Tools (69)

- `immich_ping`
- `immich_get_server_info`
- `immich_get_server_statistics`
- `immich_get_capabilities`
- `immich_get_storage`
- `immich_list_assets`
- `immich_get_asset`
- `immich_get_asset_exif`
- `immich_get_asset_statistics`
- `immich_download_asset_original`
- `immich_download_asset_thumbnail`
- `immich_upload_asset_from_path`
- `immich_update_asset`
- `immich_bulk_update_assets`
- `immich_delete_asset`
- `immich_restore_from_trash`
- `immich_search_smart`
- `immich_search_metadata`
- `immich_search_explore`
- `immich_list_albums`
- `immich_get_album`
- `immich_get_album_statistics`
- `immich_create_album`
- `immich_update_album`
- `immich_add_assets_to_album`
- `immich_delete_album`
- `immich_search_then_album`
- `immich_list_people`
- `immich_get_person`
- `immich_get_person_assets`
- `immich_update_person`
- `immich_hide_person`
- `immich_merge_people`
- `immich_suggest_face_names`
- `immich_list_tags`
- `immich_get_tag`
- `immich_create_tag`
- `immich_update_tag`
- `immich_add_tag_to_assets`
- `immich_list_shared_links`
- `immich_get_shared_link`
- `immich_create_shared_link`
- `immich_update_shared_link`
- `immich_list_activities`
- `immich_get_activity_statistics`
- `immich_create_activity`
- `immich_list_memories`
- `immich_get_memory`
- `immich_memories_today`
- `immich_daily_digest`
- `immich_list_duplicates`
- `immich_resolve_duplicates`
- `immich_categorize_duplicates`
- `immich_find_byte_dupes`
- `immich_resolve_with_keep_strategy`
- `immich_explain_duplicate_group`
- `immich_find_clip_dupes`
- `immich_compare_assets`
- `immich_audit_active`
- `immich_audit_trash`
- `immich_list_stacks`
- `immich_create_stack`
- `immich_update_stack`
- `immich_delete_stack`
- `immich_list_trash`
- `immich_restore_by_query`
- `immich_empty_trash`
- `immich_list_jobs`
- `immich_run_job`

## FAQ

### Can an AI agent delete my photos?

By default, writes are disabled and destructive calls require explicit confirmation via a 'confirm: true' flag to prevent accidental deletions.

### What kind of tasks can the MCP adapter perform?

The adapter allows AI clients to browse and search photo libraries, manage albums and tags, recognize people, surface memories, and resolve duplicates.

### How do I secure the HTTP mode for remote access?

HTTP mode requires a random 32-character bearer token (IMMICH_MCP_HTTP_TOKEN) and it is recommended to use a trusted TLS proxy or tunnel.
