immich-library-mcp
by snickery
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TZ | No | Time zone used for date filters. | UTC |
| PORT | No | Port used in HTTP mode. | 8336 |
| EXPORT_DIR | No | Persistent export root used by immich_export and immich_download(destination='export'); must be a dedicated folder (home dirs such as ~, ~/Pictures, ~/Desktop are refused). | ~/Pictures/Immich Exports |
| IMMICH_URL | No | Immich server base URL, without /api. | http://immich:2283 |
| SHARED_DIR | No | Cross-MCP mount used for hand-offs to other MCP servers. | /shared |
| IMMICH_API_KEY | Yes | Read-only Immich API key. Scope it to read permissions only: asset.read asset.view asset.download asset.statistics album.read album.statistics person.read person.statistics tag.read timeline.read map.read map.search memory.read server.about user.read duplicate.read stack.read queue.read folder.read | |
| IMMICH_TIMEOUT | No | Request timeout in seconds; cold smart search pays a CLIP model load. | 60 |
| MCP_BEARER_TOKEN | No | Bearer token required for HTTP mode (fails closed). Not needed for stdio mode. | |
| IMMICH_PUBLIC_URL | No | Browser-facing base URL used for the url on every row; set it when the server reaches Immich by an internal address. | IMMICH_URL |
| MAX_DOWNLOAD_BYTES | No | Cap per streamed file (originals, videos). Default 2 GiB. | 2147483648 |
| IMMICH_WRITE_API_KEY | No | Optional curation key. When set, the organising (write) tools are registered. Scope it to exactly asset.update asset.upload tag.create tag.asset tag.delete album.create album.update album.delete albumAsset.create albumAsset.delete person.update person.merge job.create and no read permissions. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityNo data
ResponsivenessNo issues