← Back to directory

Todoist MCP Server

Official

Official MCP server to connect AI agents to Todoist.

GitHub source repository ↗

★ 538 Stars Category · Collaboration Very popular Source revision 1d5cdf9bfede

40FMRS · D

Reliability

5/20

Security and permissions

6/20

Maintenance

7/20

Documentation

10/20

Setup experience

12/20

The Todoist MCP server is officially maintained and offers reliable task management integration. Its design emphasizes reusability and complete workflows rather than isolated atomic actions. It supports multiple popular clients and is easy to install and configure. Suitable for individuals and developers, but attention should be paid to permissions and data security.

Read the FMRS scoring method →

An official MCP server by Doist that allows AI agents to access and modify a Todoist account on behalf of the user. Provides a set of reusable tools that can be used via MCP or integrated directly into custom AI conversational interfaces.

Tools

Follows the OpenAI MCP specification, performs search operations, returns JSON-encoded results.

fetch

Follows the OpenAI MCP specification, fetches content, returns JSON-encoded results.

findTasksByDate

Finds tasks by date.

addTasks

Adds new tasks.

other_tools_in_src_tools

More tools are available in the src/tools directory; see the full list.

Setup

Quick start with npx: npx @doist/todoist-mcp
For Claude Desktop: Settings → Connectors → Add custom connector, enter https://ai.todoist.net/mcp and complete OAuth authentication.
For Cursor: create configuration in ~/.cursor/mcp.json or project-specific .cursor/mcp.json (see install_config).
For Claude Code: use the official plugin with /plugin marketplace add doist/todoist-mcp and /plugin install todoist@doist, or manually run claude mcp add --transport http todoist https://ai.todoist.net/mcp.
For VS Code: Command Palette → MCP: Add Server, select HTTP transport, use the provided JSON configuration.
For other clients: run npx -y mcp-remote https://ai.todoist.net/mcp.

claude_desktop_config.json

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.todoist.net/mcp"
      ]
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Users who need AI assistants to directly operate Todoist tasks.
Developers who want seamless task management in AI tools like Claude, Cursor, VS Code.
Developers who want to build custom AI workflows with reusable tools.

Not for

Users who do not need AI task management features.
Enterprises requiring multi-user collaboration or permission management (this server operates on a single user account).
Users with strict data privacy requirements (third-party service may need evaluation).

Required permissions

Requires a valid Todoist API key (TODOIST_API_KEY) or OAuth authentication.
Tools can read and modify user's Todoist account data, including tasks, projects, and labels.

Risks and side effects

AI agents may accidentally delete or modify tasks; it is recommended to use a test account or temporary project.
Leaked API keys or OAuth tokens could lead to unauthorized account access.
As it relies on external services, there is potential for downtime or latency.

Troubleshooting

Ensure TODOIST_API_KEY is set correctly; use `npm run tool -- user-info '{}'` to verify connected account.
Check network connectivity and firewall to ensure access to `https://ai.todoist.net/mcp`.
For write operations, use a test environment first to avoid accidental data modification.

Use cases

Let AI assistants help users manage tasks in Todoist, such as searching, creating, and modifying tasks.

Interact with Todoist account via natural language with AI.

Integrate Todoist tools into custom AI applications for task automation.

Supported clients

Claude DesktopFull support

CursorFull support

Claude Code (CLI)Full support

Visual Studio CodeFull support

Other MCP ClientsFull support

Related MCP servers

Compare with other MCP servers