Todoist MCP Server

Todoist MCP Server (Python)

A Todoist MCP server written in Python, using the Todoist Python API. I first created the server by using Claude to translate this TypeScript Todoist MCP server to Python. I'm gradually changing and adding functionality to suit my workflow as I experiment with using Claude to help with task management.

Installation

Prerequisites

Python 3.10+
UV package manager (installation guide)
Todoist API token

Getting a Todoist API Token

Log in to your Todoist account
Go to Settings → Integrations
Find your API token under "Developer"

Configuration with Claude Desktop

Add the MCP server to your claude_desktop_config.json,

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mikemc/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Or, to run from a local copy,

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Available Tools

To see currently available tools, run

# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py

As of 2025-05-26,

Projects
- todoist_get_projects
- todoist_get_project
- todoist_add_project
- todoist_update_project
- todoist_delete_project
Sections
- todoist_get_sections
- todoist_get_section
- todoist_add_section
- todoist_update_section
- todoist_delete_section
Tasks
- todoist_get_task
- todoist_get_tasks
- todoist_filter_tasks
- todoist_add_task
- todoist_update_task
- todoist_complete_task
- todoist_uncomplete_task
- todoist_move_task
- todoist_delete_task
Comments
- todoist_get_comment
- todoist_get_comments
- todoist_add_comment
- todoist_update_comment
- todoist_delete_comment

License

This project is licensed under the MIT License. See the LICENSE file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A Python server that enables Claude to interact with Todoist's task management API, allowing users to create, manage, and organize tasks directly through Claude's interface.

Related MCP Servers

Todoist MCP Server
Chrusic
A
security
A
license
A
quality
Integrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.
Last updated -
19
35
12
JavaScript
MIT License
Todoist MCP Server
abhiz123
A
security
A
license
A
quality
An MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.
Last updated -
5
245
153
JavaScript
MIT License
MCP Todoist
dkeesey
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude to interact with your Todoist account, allowing you to manage tasks, projects, and labels through natural language.
Last updated -
1
Python
Todoist MCP Server
stevengonsalvez
-
security
-
license
-
quality
A Model Context Protocol server that enables advanced task and project management in Todoist via Claude Desktop and other MCP-compatible clients.
Last updated -
JavaScript
MIT License

View all related MCP servers

Todoist MCP Server