Todoist MCP Server
Provides tools for managing tasks, projects, labels, sections, and comments through the Todoist API.
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 Create a task to buy groceries 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
A Model Context Protocol (MCP) server that provides tools for interacting with Todoist, enabling AI assistants to manage tasks, projects, labels, sections, and comments through the Todoist API.
Configuration
This server requires a Todoist API token to function.
Get your API token:
Go to Todoist Settings.
Scroll down to the "API token" section.
Copy your personal API token.
Configure your MCP client: Add the server to your MCP client configuration, making sure to include your API token. For Claude Desktop, you would add one of the following to your
claude_desktop_config.json:Docker
{ "mcpServers": { "todoist": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "TODOIST_API_TOKEN=your_api_token_here", "ghcr.io/ganievs/todoist-mcp-server:latest" ] } } }NPX
{ "mcpServers": { "todoist": { "command": "npx", "args": [ "-y", "@ganiev/todoist-mcp-server" ], "env": { "TODOIST_API_TOKEN": "your_api_token_here" } } } }
Related MCP server: Todoist MCP
Usage
Once configured, you can use natural language to interact with Todoist through your MCP client:
"Create a task to buy groceries with high priority"
"List all my projects"
"Add a comment to the task about the meeting"
"Create a new project for my vacation planning"
"Show me all tasks with the 'urgent' label"
Development
To set up the project for development:
Clone the repository:
git clone https://github.com/ganievs/todoist-mcp-server.git cd todoist-mcp-serverInstall dependencies:
npm installRun the linter:
npm run lintBuild the project:
npm run build
Support
For issues and feature requests, please use the GitHub Issues page.
Available Tools
27 toolsadd_commentC
Add a comment to a task
Inputs: content (required), task_id, project_id, attachment.
add_labelD
Create a label
Inputs: name (required), color, isFavorite, order.
add_projectB
Create a new Todoist project
Inputs: name (required), parent_id, color, is_favorite, +1 more.
add_sectionB
Create a new section in a Todoist project
Inputs: name (required), project_id (required), order.
add_taskB
Create a TODO task
Inputs: content (required), description, priority, labels, +2 more.
close_taskC
Close a TODO task
Inputs: task_id (required).
delete_commentC
Delete a comment
Inputs: comment_id (required).
delete_labelC
Delete a label
Inputs: label_id (required).
delete_projectC
Delete a Todoist project
Inputs: project_id (required).
delete_sectionC
Delete a Todoist section
Inputs: section_id (required).
delete_taskB
Delete a TODO task
Inputs: task_id (required).
get_commentC
Get a comment
Inputs: comment_id (required).
get_labelB
Get a label
Inputs: label_id (required).
get_projectC
Get details of a Todoist project
Inputs: project_id (required).
get_project_collaboratorsC
Get collaborators for a Todoist project
Inputs: project_id (required), cursor, limit.
get_sectionB
Get details of a Todoist section
Inputs: section_id (required).
get_taskC
Get a TODO task
Inputs: task_id (required).
list_commentsC
List and filter comments
Inputs: task_id, project_id, cursor, limit.
list_labelsC
List and filter labels
Inputs: cursor, limit.
list_projectsC
List all Todoist projects
Inputs: cursor, limit.
list_sectionsB
List all sections in a Todoist project
Inputs: project_id (required), cursor, limit.
list_tasksB
List and filter TODO tasks
Inputs: project_id, label, section_id, parent_id, +1 more.
reopen_taskB
Reopen a TODO task
Inputs: task_id (required).
update_commentC
Update a comment
Inputs: comment_id (required), content (required).
update_projectC
Update an existing Todoist project
Inputs: project_id (required), name, color, is_favorite, +1 more.
update_sectionB
Update an existing Todoist section
Inputs: section_id (required), name (required).
update_taskC
Update a TODO task
Inputs: task_id (required), content (required), description, priority, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
Each tool targets a distinct resource and action. There is no overlap in purpose; for example, add_task and add_project operate on different resources, and get_task vs list_tasks are clearly separated.
All tool names follow a consistent verb_noun pattern (e.g., add_task, delete_comment, list_projects). The verbs and nouns are standardized, making it easy to predict the naming for any missing operation.
27 tools is on the higher end but appropriate given the number of resource types (task, project, section, label, comment) with full CRUD plus extras like close/reopen and collaborators. It could potentially be trimmed but is still well-scoped.
The set covers all major CRUD lifecycle for tasks, projects, sections, labels, and comments, plus close/reopen for tasks. Minor gaps exist (e.g., no move_task or assign_task) but the core workflows are complete.
Maintenance
Related MCP Connectors
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Todoist task management platform through its API, supporting all features from the official Todoist TypeScript Client.349 npmMIT
- 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.349 npm4MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Todoist for comprehensive task management, enabling natural language creation, updating, and organization of tasks, projects, sections, and labels.17 npm3MIT
- 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.17 npmMIT