Todoist MCP server

Last verified: 2026-09

Inbox and projects in Todoist.

Community Chat, mail & docs Needs a secret Claude Desktop, Cursor, Windsurf, Claude Code

What it does

Doist's Todoist tools. The npm package is both an MCP server and a library (findTasksByDate, addTasks). Personal API token.

It sits in Chat, mail & docs: These servers act as the bot or the integration you install.

Good for

List today's tasks before adding any.
Add a one-off to a test project from the chat.
Complete a task you just finished without opening the app.
Keep it off shared workspaces until you have seen create.

Tools

search / fetch — Find tasks (MCP surface).
add / complete / update tasks — Writes — names follow @doist/todoist-mcp.

Config (Claude Desktop / Cursor / Windsurf)

Paste the JSON below. Same mcpServers shape. Replace placeholder paths and secrets. Windows paths look like C:\\Users\\you\\project, not /path/to. Host-side steps →

Claude Desktop

OS	Config file
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json` (usually `C:\Users\<you>\AppData\Roaming\Claude\`)
Linux	`~/.config/Claude/claude_desktop_config.json`

Cursor

Scope	macOS / Linux	Windows
This project	`.cursor/mcp.json` in the repo root
This user	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`

Windsurf

OS	Config file
macOS / Linux	`~/.codeium/windsurf/mcp_config.json`
Windows	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "..."
      }
    }
  }
}

Windsurf remote MCP: use serverUrl instead of url if the block below is HTTP.

One-liner: npx -y todoist-mcp

Secrets it wants: TODOIST_API_TOKEN

Source repo →

How to get started

Create a Todoist API token. Set TODOIST_API_TOKEN.
Ask it to list today's tasks before adding any.
Use a test project if you are evaluating.

Access risk

It will create and complete tasks as you. Low blast radius unless you share projects.

When to skip it

Skip it for Asana/Linear team trackers.

Instead: Asana, Linear, Notion.

Chat, mail & docsAsanaTasks and projects in Asana. Chat, mail & docsLinearIssues, projects, and cycles in Linear. Chat, mail & docsNotionSearch and update Notion pages.

Vs alternatives

Server	Official?	Needs a secret?	Best for
Todoist	No	Yes	Inbox and projects in Todoist.
Asana	No	Yes	Tasks and projects in Asana.
Linear	No	Yes	Issues, projects, and cycles in Linear.
Notion	No	Yes	Search and update Notion pages.

More in Chat, mail & docs

OfficialGoogle MapsGeocode and place search via Google Maps. OfficialSlackRead channels and post messages. Chat, mail & docsAsanaTasks and projects in Asana. Chat, mail & docsConfluenceRead Confluence pages.

All 18 in this category →

FAQ

Library or MCP?

Doist publishes @doist/todoist-mcp as both. The MCP surface uses your TODOIST_API_TOKEN.

Todoist or Asana?

Personal inbox vs team work OS. Do not dual-write the same work.

Blast radius?

Low unless you share projects. It will still create and complete as you.

Official Doist?

Yes — github.com/Doist/todoist-ai.