claw2immich is a Python MCP (Model Context Protocol) server that exposes selected Immich REST API endpoints. It uses the Immich OpenAPI spec for API
claw2immich is a Python MCP (Model Context Protocol) server that exposes selected Immich REST API endpoints. It uses the Immich OpenAPI spec for API metadata and
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
ping_server — get_server_versiontool_access_report — write_capability_reportparams — summary of required path/query/body fieldsexample — short call sketch for required inputsreturns — response schema title and key fields when availableread_only — The read_only tool exposed by this serverread_write — The read_write tool exposed by this serverfull_scope — The full_scope tool exposed by this serverping_server — get_server_versiontool_access_report — write_capability_reportparams — summary of required path/query/body fieldsexample — short call sketch for required inputsread_only — The read_only tool exposed by this server.read_write — The read_write tool exposed by this server.full_scope — The full_scope tool exposed by this server.Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| ping_server | get_server_version |
| tool_access_report | write_capability_report |
| params | summary of required path/query/body fields |
| example | short call sketch for required inputs |
| read_only | The read_only tool exposed by this server. |
| read_write | The read_write tool exposed by this server. |
| full_scope | The full_scope tool exposed by this server. |
{
"mcpServers": {
"claw2immich-readonly": {
"command": "python",
"args": ["c:\\path\\to\\claw2immich\\main.py"],
"env": {
"IMMICH_BASE_URL": "https://immich.example.com",
"IMMICH_API_KEY": "your-read-only-key",
"IMMICH_PROFILE": "read_only"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| IMMICH_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| IMMICH_API_KEY | Credential the server authenticates with. | Yes |
| IMMICH_PROFILE | Configuration value read at startup. | Optional |
| IMMICH_API_TOKEN | Credential the server authenticates with. | Yes |
| IMMICH_WRITE_PROBE_PATH | Filesystem location the server is allowed to use. | Optional |
| MCP_MOUNT_PATH | Filesystem location the server is allowed to use. | Optional |
| MCP_TEST_HOST | Endpoint or connection string the server talks to. | Optional |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.