About Todoist MCP Server
Todoist MCP Server connects LLMs to Todoist for task and project operations, covering tasks, comments, labels, and collaboration data.
Key features
- 01Create and edit tasks
- 02Parse natural-language task input
- 03Retrieve active and completed tasks
- 04Manage projects and sections
- 05Manage comments and labels
- 06View project collaborators and statistics
Use cases
- 01Add tasks with due dates and priorities
- 02Review completed tasks and productivity statistics
- 03Organize projects, sections, and labels
MCP support
Exposes Todoist operations to MCP clients, including task, project, section, comment, label, and collaborator management.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETodoist MCP
Connect this Model Context Protocol server to your LLM to interact with Todoist.
Functionality
This integration implements all the APIs available from the Todoist TypeScript Client, providing access to:
Task Management
- Create tasks (with content, descriptions, due dates, priorities, labels, and more)
- Create tasks with natural language (e.g., "Submit report by Friday 5pm #Work")
- Retrieve tasks (individual, filtered, or all tasks)
- Retrieve completed tasks (by completion date or due date)
- Get productivity statistics
- Update tasks
- Move tasks (individually or in batches)
- Close/reopen tasks
- Delete tasks
Project Management
- Create, retrieve, update, and delete projects
Section Management
- Create, retrieve, update, and delete sections within projects
Comment Management
- Add, retrieve, update, and delete comments for tasks or projects
Label Management
- Create, retrieve, update, and delete labels
- Manage shared labels
Collaboration
- Get collaborators for projects
Setup
Build the server app:
npm install
npm run build
Configure Claude:
You must install the Claude desktop app which supports MCP.
You can get your Todoist API key from Todoist > Settings > Integrations > Developer.
Then, in your claude_desktop_config.json, add a new MCP server:
{
"mcpServers": {
"todoist-mcp": {
"command": "node",
"args": ["/path/to/repo/build/index.js"],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_key"
}
}
}
}
You can now launch Claude desktop app and ask to update Todoist.
Distribution
Smithery
Install Todoist MCP on Claude Desktop using Smithery:
npx -y @smithery/cli install @miottid/todoist-mcp --client claude
Glama
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.