Todoist MCP Server

Full implementation of Todoist Rest API & support Todoist Sync API for MCP server

Local serverstdio

What is the Todoist MCP server?

Full implementation of Todoist Rest API & support Todoist Sync API for MCP server. That is what the todoist mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

  • Complete Todoist API Integration — Access to the full Todoist REST API v2, and support for the Todoist Sync API through natural language
  • Batch Processing — Client can process multiple tasks in a single request
  • Search by name — AI can search for tasks, projects, and labels by name instead of ID
  • Tasks — Create, update, close, reopen, move, and delete tasks using conversational language
  • Projects — Create and manage projects and sections
  • Comments — Add and manage comments on tasks and projects

Getting it running

The server ships on npm as todoist-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

The tools it exposes

The server publishes 10 tools. What each one is for:

  • Platform — Config
  • Cursor — ~/.cursor/mcp.json or .cursor/mcp.json
  • Codex — ~/.codex/config.toml or .codex/config.toml — see example below
  • Usage — The Usage tool exposed by this server
  • Tasks — The Tasks tool exposed by this server
  • Projects — The Projects tool exposed by this server
  • Sections — The Sections tool exposed by this server
  • Comments — The Comments tool exposed by this server
  • Labels — The Labels tool exposed by this server
  • Utils — The Utils tool exposed by this server

What it needs from you

Configuration is passed through the environment: API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Todoist.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Todoist's toolset — Platform, Cursor, Codex and 7 more — is a fair guide to whether it matches your workflow. It is maintained by stanislavlysenko0912; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
PlatformConfig
Cursor~/.cursor/mcp.json or .cursor/mcp.json
Codex~/.codex/config.toml or .codex/config.toml — see example below
UsageThe Usage tool exposed by this server.
TasksThe Tasks tool exposed by this server.
ProjectsThe Projects tool exposed by this server.
SectionsThe Sections tool exposed by this server.
CommentsThe Comments tool exposed by this server.
LabelsThe Labels tool exposed by this server.
UtilsThe Utils tool exposed by this server.

How to install the Todoist MCP server

{
  "mcpServers": {
    "todoist-mcp-server-stanislavlysenko0912": {
      "command": "npx",
      "args": ["-y", "todoist-mcp"],
      "env": {
        "API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Todoist to Platform.
  • Use Todoist to Cursor.
  • Use Todoist to Codex.

Frequently asked questions

You need a Todoist API token, which can be found in Todoist Settings → Integrations.