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.
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 the MCP server to your claude_desktop_config.json,
Or, to run from a local copy,
Available Tools
To see currently available tools, run
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.
You must be authenticated.
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
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
- AsecurityAlicenseAqualityIntegrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.Last updated -193512JavaScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.Last updated -5245153JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.Last updated -13PythonMIT License
- AsecurityFlicenseAqualityA server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.Last updated -15Python