Skip to main content

Getting Started

TodoMate is a developer-focused todo app built around an API-first architecture. Everything you can do in the app, you can also do via the API or the CLI.

Clients​

ClientBest for
Web appEveryday use in the browser
CLI (todo)Terminal workflows, scripting
MCP serverAI assistants (Claude, etc.)
REST APICustom integrations

Authentication​

All API access requires:

  1. A JWT — issued via GitHub OAuth. The web app, CLI, and MCP server handle this for you.
  2. An API key — Pro users can generate one from the Account screen → API Keys.

See the REST API guide for details on authentication and required headers.