Todoist
About
Create and manage tasks in Todoist through natural language.
Details
- Author
- abhiz123
- Repository
- abhiz123/todoist-mcp-server
- GitHub stars
- 157
- Downloads
- 7,331
- License
- MIT License
- Categories
- Productivity, Project Management, Developer Tools, Design, AI, Search, Frontend, API
- Tags
- #mobile
Jump to
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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
TodoistCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@abhiz123/todoist-mcp-server
Environment-
TODOIST_API_TOKEN
your_api_token_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Todoist MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
npm install -g @abhiz123/todoist-mcp-server
1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under "Developer"
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"
}
}
}
}
"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"
npm install
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'.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"todoist": {
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
},
"args": [
"-y",
"@abhiz123/todoist-mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
},
"args": [
"-y",
"@abhiz123/todoist-mcp-server"
],
"command": "npx"
}Macos
{
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
},
"args": [
"-y",
"@abhiz123/todoist-mcp-server"
],
"command": "npx"
}Windows
{
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
},
"args": [
"/c",
"npx",
"-y",
"@abhiz123/todoist-mcp-server"
],
"command": "cmd"
}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.
<a href="https://glama.ai/mcp/servers/fhaif4fv1w">
</a>
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:
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
Manual Installation
npm install -g @abhiz123/todoist-mcp-server
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
1. Log in to your Todoist account 2. Navigate to Settings → Integrations 3. 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
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
