Build with Todoist

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.

Everything you need to build

Every Todoist app comes with building blocks for developers and AI agents. Pick an app, then the block that fits your project.

Todoist

Tasks and projects that turn plans into results, for individuals and teams.

API reference →

API

Tasks, projects, comments, and more, plus a Sync endpoint for batched reads and writes.

SDKs

Typed clients for Python and TypeScript, on PyPI and npm.

MCP server

Hosted server for Claude, ChatGPT, Cursor, and more.

CLI

td for quick capture, scripts, and coding agents.

Webhooks

Get notified the moment tasks and projects change.

Todoist Comms Beta

Channels, threads, and chats where teams talk things through and decide.

Developer docs →

API

Build bots and internal tools around channels, threads, and chats.

SDK

A typed TypeScript client for the full API.

MCP server

Catch up, search, and reply from your AI app.

CLI

tdc to post from scripts, CI jobs, and coding agents.

Webhooks

React the moment something happens in Comms.

Todoist Automations Beta

Describe a workflow in plain language and it runs on its own. On Pro and Business plans.

About Automations →

MCP server

Create, run, and fix automations from ChatGPT, Claude, and more.

CLI

tda to manage automations, runs, and connections.

AI agents welcome

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.

Connect over MCP

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

Give your coding agent the CLIs

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

Make your first call

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.