Everywhere you are
The API
A REST API for reading and writing your lists and things.
Why you'd care
Everything the app does with your data, you can do yourself. Scripts, dashboards, a custom capture tool, a migration you would rather run than click through.
The full reference
Lives at the developers page, generated from the live specification with request and response shapes, code samples in several languages, and an OpenAPI document. It is always current, which is why it is not duplicated here. See API reference.
What it covers
Things, including bulk operations and Markdown import and export. Lists, including creating one from a document. Today. Reminders. Search. Tags. Your account.
When to use it
Use the API when you are building something, or doing a one-off bulk job.
Use an automation platform when you want to connect two services and would rather not run anything. See Zapier, Pipedream, IFTTT.
Use MCP when you want an AI assistant to do it conversationally. See MCP.
The basics
- JSON over HTTPS, authenticated with a personal API key as a bearer token
- Scoped keys, so a script can be read-only
- 1000 requests an hour per key
- CORS-open, so it can be called from a browser as well as a server