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.