Todoist MCP (official, Doist)

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "todoist-mcp-official-doist": {
      "command": "npx",
      "args": [
        "-y",
        "@doist/todoist-mcp"
      ],
      "env": {
        "TODOIST_API_KEY": "<your-todoist-api-key>"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

• Node.js (an .nvmrc pins the supported version; Node 18+ recommended) if running the npm package locally
• A Todoist account
• For local/stdio use: a Todoist API token from Todoist → Settings → Integrations → Developer, set as the TODOIST_API_KEY environment variable
• For the hosted remote endpoint (https://ai.todoist.net/mcp): no token needed — OAuth runs in the browser on first use

About Todoist MCP (official, Doist)

Tools & capabilities (14)

What this server can do

Todoist MCP (official, Doist) provides tools for these capabilities — tap one to see every MCP server that does the same:

When to use it

• Use it when you want an agent to fully manage Todoist — not just tasks, but projects, sections, labels, filters, and reminders.
• Use it when you'd rather connect to a hosted, OAuth-secured endpoint than juggle API tokens in a local config.
• Use it when you want productivity analytics (project health, completion stats, workspace insights) surfaced in chat.
• Use it when you need OpenAI-compatible search/fetch tools so the same server works across multiple AI clients.
• Use it when you want official vendor support and an API surface that tracks Todoist features closely.

Quick setup

1. 1Decide between local (stdio) or the hosted remote endpoint at https://ai.todoist.net/mcp.
2. 2For local: get a Todoist API token from Settings → Integrations → Developer.
3. 3Add the server to your client config — e.g. command `npx`, args `@doist/todoist-mcp`, with env `TODOIST_API_KEY` set (or point at the remote URL for OAuth).
4. 4Restart your MCP client (Claude Desktop, Cursor, Claude Code, or VS Code).
5. 5If using the remote endpoint, complete the browser OAuth flow the first time a Todoist tool is called.
6. 6Verify by asking the agent to list today's tasks or create a test task.

Todoist MCP (official, Doist) FAQ