Todoist MCP Server
The Todoist MCP Server integrates Claude with Todoist to enable natural language task management. With this server, you can:
Create tasks: Add new tasks with content, description, due dates, and priority levels
Retrieve tasks: Filter tasks by due date, priority, or project using natural language
Update tasks: Modify existing task attributes by searching for them by name
Complete tasks: Mark tasks as complete using natural language search
Delete tasks: Remove tasks by searching for them by name
Enables natural language task management in Todoist, allowing users to create, retrieve, update, complete, and delete tasks with support for task attributes like descriptions, due dates, and priority levels.
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 Add a high priority task 'Finish quarterly report' due tomorrow"
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
An MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks using everyday language.
Features
Natural Language Task Management: Create, update, complete, and delete tasks using everyday language
Smart Task Search: Find tasks using partial name matches
Flexible Filtering: Filter tasks by due date, priority, and other attributes
Rich Task Details: Support for descriptions, due dates, and priority levels
Intuitive Error Handling: Clear feedback for better user experience
Related MCP server: Enhanced Todoist MCP Server Extended
Installation
Installing via Smithery
To install Todoist MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claudeManual Installation
npm install -g @abhiz123/todoist-mcp-serverTools
todoist_create_task
Create new tasks with various attributes:
Required: content (task title)
Optional: description, due date, priority level (1-4)
Example: "Create task 'Team Meeting' with description 'Weekly sync' due tomorrow"
todoist_get_tasks
Retrieve and filter tasks:
Filter by due date, priority, or project
Natural language date filtering
Optional result limit
Example: "Show high priority tasks due this week"
todoist_update_task
Update existing tasks using natural language search:
Find tasks by partial name match
Update any task attribute (content, description, due date, priority)
Example: "Update meeting task to be due next Monday"
todoist_complete_task
Mark tasks as complete using natural language search:
Find tasks by partial name match
Confirm completion status
Example: "Mark the documentation task as complete"
todoist_delete_task
Remove tasks using natural language search:
Find and delete tasks by name
Confirmation messages
Example: "Delete the PR review task"
Setup
Getting a Todoist API Token
Log in to your Todoist account
Navigate to Settings → Integrations
Find your API token under "Developer"
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
}
}
}
}Example Usage
Creating Tasks
"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"Getting Tasks
"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"Updating Tasks
"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"Completing Tasks
"Mark the PR review task as complete"
"Complete the documentation task"Deleting Tasks
"Delete the PR review task"
"Remove meeting prep task"Development
Building from source
# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git
# Navigate to directory
cd todoist-mcp-server
# Install dependencies
npm install
# Build the project
npm run buildContributing
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
5 toolstodoist_complete_taskB
Mark a task as complete by searching for it by name
Inputs: task_name (required).
todoist_create_taskB
Create a new task in Todoist with optional description, due date, and priority
Inputs: content (required), priority, due_string, description.
todoist_delete_taskB
Delete a task from Todoist by searching for it by name
Inputs: task_name (required).
todoist_get_tasksA
Get a list of tasks from Todoist with various filters
Inputs: limit, filter, priority, project_id.
todoist_update_taskB
Update an existing task in Todoist by searching for it by name and then updating it
Inputs: task_name (required), content, priority, due_string, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation (create, read, update, delete, complete) on tasks, with no overlap. The descriptions clearly differentiate the actions.
All tools follow a consistent 'todoist_verb_task' pattern (e.g., todoist_complete_task, todoist_create_task), using snake_case and clear verbs.
With 5 tools, the set covers the essential CRUD operations plus a completion action, which is appropriate for a task management server. No excessive or missing tools.
The tools cover full CRUD (create, get, update, delete) and a common operation (complete), which is sufficient for basic task management. Minor gaps like reordering or sharing tasks are not critical.
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that connects Claude with Todoist for complete task and project management through natural language.86203 npm246MIT
- AlicenseBqualityDmaintenanceA comprehensive MCP server that provides full integration between Claude and Todoist, enabling task, project, section, and label management through 24 different tools with the complete Todoist API.306MIT
- AlicenseNot gradedqualityDmaintenanceA custom MCP server that connects Claude to Todoist using a permanent API token, avoiding OAuth re-authentication issues across all Claude surfaces.111 npmMIT
- AlicenseAqualityDmaintenanceA local MCP server for Todoist task management, enabling Claude to create, read, update, complete, delete, and move tasks, manage projects and labels, and add comments via the Todoist REST and Sync APIs.151MIT