MCP Directory

How to add Todoist MCP (official, Doist) to Cursor

Doist's official Todoist MCP server — manage tasks, projects, and labels on your behalf. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 510★ · stdio · apikey · official

Cursor config for Todoist MCP (official, Doist)

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

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Todoist MCP (official, Doist) config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Todoist MCP (official, Doist)'s tools to confirm it's connected.

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

What Todoist MCP (official, Doist) can do in Cursor

add-tasks

Create one or more tasks with content, due dates, priority, labels, and project/section.

find-tasks

Find tasks by query, filtering by project, label, or other attributes.

find-tasks-by-date

Find tasks scheduled for a given date or date range.

update-tasks

Update existing tasks (content, due date, priority, etc.).

complete-tasks

Mark tasks as complete (and uncomplete-tasks to reopen them).

reschedule-tasks

Move tasks to new due dates.

add-projects / find-projects / update-projects

Create, list, and edit projects; project-move and project-management for restructuring.

add-sections / update-sections / find-sections

Manage sections within projects.

Security

The TODOIST_API_KEY grants full read/write access to your tasks and projects, so store it in env vars and revoke it from Todoist settings if leaked. The hosted ai.todoist.net option uses OAuth and avoids storing the key locally.

Todoist MCP (official, Doist) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Todoist MCP (official, Doist) config there under the "mcpServers" key and restart the client.

Is Todoist MCP (official, Doist) safe to use with Cursor?

The TODOIST_API_KEY grants full read/write access to your tasks and projects, so store it in env vars and revoke it from Todoist settings if leaked. The hosted ai.todoist.net option uses OAuth and avoids storing the key locally.

Is this the official Todoist MCP server?

Yes. It's published under the @doist npm scope and maintained by Doist, the company that makes Todoist.

Do I need an API token, or can I use OAuth?

Both work. The local npm package uses a TODOIST_API_KEY from Settings → Integrations → Developer; the hosted endpoint at ai.todoist.net/mcp uses browser OAuth on first use.

What's the npm package name?

@doist/todoist-mcp. It was previously published as @doist/todoist-ai.

View repo Full Todoist MCP (official, Doist) page