Todoist MCP Server Extended
Enables natural language task management through Todoist's API, providing tools for creating, updating, completing, and deleting tasks, managing projects and sections, organizing labels, filtering tasks by various criteria, and performing batch operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Todoist MCP Server Extended add 'buy groceries' to my shopping list project with high priority"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Todoist MCP Server Extended
An MCP (Model Context Protocol) server implementation that integrates Claude - or any MCP compatible LLM if you're crafty - with Todoist, enabling natural language task management via MCP tools. The tools in this server allows Claude to interact with your Todoist tasks, projects, sections, and labels using everyday language, while also optimized for LLM workflow efficiency.
Features Overview
Task Management: Create, update, complete, and delete tasks using everyday language
Label Management: Create, update, and manage personal labels and task labels
Project Management: Create, update, and manage Todoist projects
Section Organization: Create and manage sections within projects
Smart Search: Find tasks and labels using partial name matches
Flexible Filtering: Filter tasks by project, section, due date, priority, and labels
Rich Task Details: Support for descriptions, due dates, priority levels, and project/section assignment
Batch Operations: Tools have built in batch operation support and custom parameters for efficient usage with LLM workflows
For a complete list of available tools as well as their usage, see tools.md.
Related MCP server: Todoist MCP
Quick Installation Guide
Assuming you already have npm installed.
A more comprehensive installation guide can be found in the How-to Guide.
Installing via Smithery
To install Todoist MCP Server Extended for Claude Desktop via Smithery:
Run following command in cmd\pwsh:
npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claudeAlso compatible with cline or windsurf, by changing last parameter to --client cline or --client windsurf
Installing via npm
Run following command in cmd\pwsh:
npm install -g @chrusic/todoist-mcp-server-extendedSetup
Grab a Todoist API Token
Log in to your Todoist account
Navigate to
Settings → IntegrationsFind your API token under
DeveloperPress
Copy API Token
For more information about the Todoist API, visit the official Todoist API documentation.
Add MCP Server and API Token Claude Desktop Client
In your
claude_desktop_config.jsonfile, paste the following json snippet between:"mcpServers":{ }:"todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } }When all put together, it should look something like this:
{ "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } } } }Claude Desktop client will then start the MCP server and load the tools on the next client (re)start.
Example Usage
Some simple suggestions on what to ask Claude. Note that sometimes you have to be very direct to get claude to use the tools:
"Using the MCP tool: todoist_get_tasks, list all my tasks for the day."
"Create task 'Review PR' in project 'Work' section 'To Do'"
"Add label 'Important' to task 'Review PR'"
"Show all tasks with label 'Important' in project 'Work'"
"Move task 'Documentation' to section 'In Progress'"
"Mark the documentation task as complete"
"Give me some suggestions for listed tasks I can do today as I'm going shopping in town."
"Break task X down in to smaller subtasks and add due dates, x, y, z."
Contributing
Contributions are welcome! Feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Issues and Support
If you encounter any issues or need support, please file an issue on the GitHub repository.
Available Tools
19 toolstodoist_complete_taskC
Mark one or more tasks as complete in Todoist
Inputs: tasks, task_id, task_name.
todoist_create_personal_labelC
Create one or more personal labels in Todoist
Inputs: labels, name, color, order, +1 more.
todoist_create_projectC
Create one or more projects with support for nested hierarchies
Inputs: projects, name, parent_id, color, +2 more.
todoist_create_project_sectionC
Create one or more sections in Todoist projects
Inputs: sections, project_id, name, order.
todoist_create_taskC
Create one or more tasks in Todoist with full parameter support
Inputs: tasks, content, description, project_id, +14 more.
todoist_delete_personal_labelC
Delete a personal label from Todoist
Inputs: label_id (required).
todoist_delete_taskC
Delete one or more tasks from Todoist
Inputs: tasks, task_id, task_name.
todoist_get_personal_labelB
Get a personal label by ID
Inputs: label_id (required).
todoist_get_personal_labelsB
Get all personal labels from Todoist
Inputs: no named parameters.
todoist_get_projectsC
Get projects with optional filtering and hierarchy information
Inputs: project_ids, include_sections, include_hierarchy.
todoist_get_project_sectionsC
Get sections from one or more projects in Todoist
Inputs: projects, project_id, project_name, include_empty.
todoist_get_tasksC
Get a list of tasks from Todoist with various filters - handles both single and batch retrieval
Inputs: project_id, section_id, label, filter, +4 more.
todoist_update_personal_labelC
Update one or more existing personal labels in Todoist
Inputs: labels, label_id, label_name, name, +3 more.
todoist_update_projectC
Update one or more projects in Todoist
Inputs: projects, project_id, name, color, +2 more.
todoist_update_taskC
Update one or more tasks in Todoist with full parameter support
Inputs: tasks, task_id, task_name, content, +14 more.
todoist_update_task_labelsC
Update the labels of one or more tasks in Todoist
Inputs: tasks, task_id, task_name, labels.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Every tool has a clearly distinct purpose targeting specific resources (tasks, projects, labels, sections) and actions (create, get, update, delete, complete, rename, remove). There is no ambiguity or overlap; for example, todoist_update_task and todoist_update_task_labels are clearly separated for different update operations.
All tools follow a consistent verb_noun pattern with the prefix 'todoist_' and snake_case throughout. The naming is predictable and readable, such as todoist_create_task, todoist_get_projects, and todoist_update_personal_label, with no deviations in style.
With 19 tools, the count is slightly high but reasonable for a comprehensive Todoist integration covering tasks, projects, labels, and sections. It feels well-scoped for the domain, though it borders on being heavy; each tool earns its place by addressing specific operations without redundancy.
The tool set provides complete CRUD/lifecycle coverage for Todoist's core domain: tasks (create, get, update, delete, complete), projects (create, get, update), labels (personal and shared with create, get, update, delete, rename, remove), and sections (create, get). There are no obvious gaps, and agents can handle full workflows without dead ends.
Maintenance
Related MCP Connectors
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- AlicenseBqualityDmaintenanceIntegrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.1926 npm22MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Todoist for comprehensive task and project management, including creating tasks with natural language, managing projects, sections, labels, comments, and tracking productivity statistics.4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, and labels through natural language, supporting task creation, updates, completion, and intelligent organization of your workflow.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Todoist through the MCP interface, providing full CRUD operations for tasks and projects including creating, updating, completing, and filtering tasks with natural language commands.12 npmMIT