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
Installation
Installing via Smithery
To install Todoist MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
Tools
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:Example Usage
Creating Tasks
Getting Tasks
Updating Tasks
Completing Tasks
Deleting Tasks
Development
Building from source
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.
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
Installation
Installing via Smithery
To install Todoist MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
Tools
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:Example Usage
Creating Tasks
Getting Tasks
Updating Tasks
Completing Tasks
Deleting Tasks
Development
Building from source
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.