Build exactly what you need
Most photo products force you to fit their workflow. Gumnut is built the other way around — a foundation you shape into the exact experience you want, on top of your photos.
Truly open by design
Every capability is reachable via REST APIs, SDKs, MCP, or the Immich API — pick the one that fits your stack, or combine them.
REST API
Gumnut supports the OpenAPI specification, so you can integrate in any language or framework of your choice — no SDK required.
Read the API reference# pip install gumnut-sdk from gumnut import Gumnut import os client = Gumnut(api_key=os.environ.get("GUMNUT_API_KEY")) results = client.search.query( q="picnic by the lake last summer", limit=10, ) for asset in results.assets: print(asset.id, asset.created_at)
// npm i gumnut-sdk import Gumnut from "gumnut-sdk"; const client = new Gumnut({ apiKey: process.env["GUMNUT_API_KEY"] }); const results = await client.search.query({ q: "picnic by the lake last summer", limit: 10, }); results.assets.forEach((a) => console.log(a.id, a.createdAt));
Native SDKs
Typed, idiomatic SDKs for Python and TypeScript — with retries, pagination, and error handling built in. You're a few lines from your first query.
Browse the SDKsMCP server
Connect Claude, ChatGPT, or any agent to see and work with your photos — full access to every operation, secured with OAuth 2.0.
Connect the MCP server
Immich compatibility
Gumnut supplies an Immich API compatibility layer, so apps and tools built for Immich work with Gumnut out of the box — mobile and web.
See the compatibility layerStart building on Gumnut today
Full reference, quickstarts, and SDKs — everything you need to ship.