The Todoist MCP Server is a Python-based server that allows you to manage your Todoist projects, sections, and tasks through a conversational interface.

Projects: Retrieve all or specific projects, create new projects (with options for color, parent, favorite status, view style), update existing projects, and delete projects.
Sections: Retrieve all or specific sections (optionally filtered by project), create new sections (with name and project ID, optional order), update sections, and delete sections.
Tasks: Retrieve tasks (with filtering options), create new tasks (with extensive options like content, description, project, section, parent, labels, priority, due dates/times, duration, assignee), update tasks, mark tasks as complete or incomplete, and delete tasks.

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" } } } }

Related MCP server: Todoist MCP Server

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.

Todoist MCP Server

Todoist MCP Server (Python)

Installation

Prerequisites

Getting a Todoist API Token

Configuration with Claude Desktop

Available Tools

License

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API