Skip to content
THE PLATFORM

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.

Open developer platform

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
OpenAPI 3.1 · api.gumnut.ai
POST/api/search
GET/api/assets/{asset_id}
POST/api/assets
GET/api/people
# 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)

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 SDKs

MCP 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
Find every photo of my kids from June before I share the album.
Done — I found 38 photos from June with the kids and grouped the best matches for review.
search_assets · person_ids✓ OAuth
Immich web and mobile interfaces showing a photo timeline

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 layer

Start building on Gumnut today

Full reference, quickstarts, and SDKs — everything you need to ship.