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.

Integrations

Provides tools for managing Todoist tasks, projects, and sections, including creating, retrieving, updating, and deleting items through the Todoist REST API.

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 to your claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/todoist-mcp-server",
        "run",
        "main.py"
      ],
      "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\(\)\()([^)]+)' main.py

As of 2025-04-21,

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_create_task
- todoist_get_tasks
- todoist_get_task
- todoist_update_task
- todoist_close_task
- todoist_reopen_task
- todoist_delete_task

License

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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.