For developers

Build on Sereo.

Sereo's web app, iOS app, CLI and MCP server are all clients of one HTTP API. A personal API token gives your own scripts and agents the same access, enforced by the same server-side rules.

Quick start

  1. Open the app and go to Settings › Data › Agent access.
  2. Name a token and choose Read only or Can change things.
  3. Copy it. It begins with sat_, authenticates as your account, and is shown once: only a digest is stored.
curl https://app.usesereo.com/v1/day/2026-11-12 \
  -H "Authorization: Bearer $SEREO_API_TOKEN"

HTTP · JSON · OpenAPI 3.1

API reference

65 endpoints with parameters, request bodies, response schemas and error codes: day, week and month views; plan generation, revision and acceptance; to-do status; goals; import and export.

Open the API reference →

Model Context Protocol

MCP reference

Configuration for the sereo-mcp stdio server and its 49 tools, each with its input schema and the endpoint it calls. Early access.

Open the MCP reference →

One surface

Validation and business rules are enforced by the API, not by clients, so your integration gets the same guarantees as the app.

Read-only tokens

A read-only token may call GET routes only. Any other method is refused with 403 read_only_token.

Questions

Bugs, missing endpoints or token problems: write to support@usesereo.com.