API
Tasks, projects, comments, and more, plus a Sync endpoint for batched reads and writes.
APIs, SDKs, MCP servers, and CLIs for every Todoist app. Built for developers and the AI agents they work with.
One Todoist account signs you in to every app.
Every Todoist app comes with building blocks for developers and AI agents. Pick an app, then the block that fits your project.
Tasks, projects, comments, and more, plus a Sync endpoint for batched reads and writes.
Channels, threads, and chats where teams talk things through and decide.
Describe a workflow in plain language and it runs on its own. On Pro and Business plans.
Agents are first-class users of every Todoist app. Whether it's a personal assistant using MCP or a coding agent in your terminal, they get the same full-featured access.
Each app has a hosted server on the same host. Add the ones you need to Claude, ChatGPT, Cursor, VS Code, or another MCP client, and sign in with your Todoist account.
# Server URLs (Streamable HTTP)
https://ai.todoist.net/mcp # Todoist
https://ai.todoist.net/mcp/comms # Comms
https://ai.todoist.net/mcp/automations # Automations
# e.g. Claude Code
claude mcp add --transport http todoist \
https://ai.todoist.net/mcp
JSON output for scripts, and installable skills for Claude Code, Codex, Cursor, Gemini, and more.
npm install -g @todoist/cli # td
npm install -g @todoist/comms-cli # tdc
npm install -g @todoist/automations-cli # tda
# Sign in and add a skill, the same for tdc and tda
td auth login
td skill install claude-code
Grab your API token from Todoist under Settings → Integrations → Developer, then create a task:
curl "https://api.todoist.com/api/v1/tasks" \
-H "Authorization: Bearer $TODOIST_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "Ship the integration", "due_string": "tomorrow"}'
The same token works with the Comms API. Building for other people? Use OAuth authorization instead of a personal token.