todoist-mcp-server

todoist-mcp-server

3.2

If you are the rightful owner of todoist-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Todoist MCP Server is a Python-based server that integrates with the Todoist API to manage tasks, projects, and sections.

Hosted by Modl, any commits or changes made by the Modl team is to ensure compatibility

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

Getting a Todoist API Token

  1. Log in to your Todoist account
  2. Go to Settings → Integrations
  3. 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-25,

  • 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_move_task
    • todoist_close_task
    • todoist_reopen_task
    • todoist_delete_task

License

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