todoist-mcp-server

kxkaloo/todoist-mcp-server

3.1

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.

Tools
18
Resources
0
Prompts
0

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.