MCP-Todoist Integration
@stevengonsalvez
MCP server for Todoist integration for Natural language task management
Overview
What is MCP-Todoist Integration?
MCP-Todoist Integration is a Model Context Protocol (MCP) server that enables language models to interact with Todoist tasks, projects, sections, labels, comments, and collaborators through the Todoist API.
How to use MCP-Todoist Integration?
Install the server via uvx (uvx install mcp-todoist), a cloned repository, or with uv. Configure it in an MCP‑compatible client like Claude Desktop by adding a JSON block with the command, arguments, and your Todoist API token as an environment variable. Once running, the language model can call the provided tools or read the available resources to manage Todoist data.
Key features of MCP-Todoist Integration
- Complete Todoist API integration for tasks, projects, sections, labels, comments, and collaborators
- Create, read, update, delete operations on all major Todoist entities
- Filter tasks by various criteria
- Access project collaborators
- Well-documented tools and resources for use with language models
Use cases of MCP-Todoist Integration
- Create a new task in Todoist with a title and due date
- Retrieve and display all tasks from a specific project
- Mark a task as complete or uncomplete
- Add a comment to an existing task
- Create a new project with multiple sections
FAQ from MCP-Todoist Integration
What are the requirements to run MCP-Todoist Integration?
Python 3.10 or higher, a Todoist account with an API token, and an MCP‑compatible client (such as Claude Desktop).
How do I obtain a Todoist API token?
Log in to your Todoist account, go to Settings > Integrations, and copy the API token from the “API token” section.
How do I configure MCP-Todoist Integration with Claude Desktop?
Add a JSON entry to Claude Desktop’s MCP Servers Configuration (under Settings > Advanced) with the command and environment variable TODOIST_API_TOKEN. You can use uvx mcp-todoist or a local Python path.
What tools does MCP-Todoist Integration provide?
It provides tools for task management (create, get, update, complete, uncomplete, delete), project management, section management, label management, comment management, and retrieving collaborators for a project.
What resources are available?
Resources include todoist://tasks, todoist://projects, todoist://labels, and filtered resources by project, section, or label.
