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
- Open the app and go to Settings › Data › Agent access.
- Name a token and choose Read only or Can change things.
- 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.
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 [email protected].