todoist-mcp-server
installs/mo · npmstarsforks
How to install todoist-mcp-server?
abhiz123/todoist-mcp-server
$git clone https://github.com/abhiz123/todoist-mcp-serverAn 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.
README.md
| 1 | # Todoist MCP Server |
| 2 | [](https://smithery.ai/server/@abhiz123/todoist-mcp-server) |
| 3 | |
| 4 | 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. |
| 5 | |
| 6 | <a href="https://glama.ai/mcp/servers/fhaif4fv1w"> |
| 7 | <img width="380" height="200" src="https://glama.ai/mcp/servers/fhaif4fv1w/badge" alt="Todoist Server MCP server" /> |
| 8 | </a> |
| 9 | |
| 10 | ## Features |
| 11 | |
| 12 | * **Natural Language Task Management**: Create, update, complete, and delete tasks using everyday language |
| 13 | * **Smart Task Search**: Find tasks using partial name matches |
| 14 | * **Flexible Filtering**: Filter tasks by due date, priority, and other attributes |
| 15 | * **Rich Task Details**: Support for descriptions, due dates, and priority levels |
| 16 | * **Intuitive Error Handling**: Clear feedback for better user experience |
| 17 | |
| 18 | ## Installation |
| 19 | |
| 20 | ### Installing via Smithery |
| 21 | |
| 22 | To install Todoist MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@abhiz123/todoist-mcp-server): |
| 23 | |
| 24 | ```bash |
| 25 | npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude |
| 26 | ``` |
| 27 | |
| 28 | ### Manual Installation |
| 29 | ```bash |
| 30 | npm install -g @abhiz123/todoist-mcp-server |
| 31 | ``` |
| 32 | |
| 33 | ## Tools |
| 34 | |
| 35 | ### todoist_create_task |
| 36 | Create new tasks with various attributes: |
| 37 | * Required: content (task title) |
| 38 | * Optional: description, due date, priority level (1-4) |
| 39 | * Example: "Create task 'Team Meeting' with description 'Weekly sync' due tomorrow" |
| 40 | |
| 41 | ### todoist_get_tasks |
| 42 | Retrieve and filter tasks: |
| 43 | * Filter by due date, priority, or project |
| 44 | * Natural language date filtering |
| 45 | * Optional result limit |
| 46 | * Example: "Show high priority tasks due this week" |
| 47 | |
| 48 | ### todoist_update_task |
| 49 | Update existing tasks using natural language search: |
| 50 | * Find tasks by partial name match |
| 51 | * Update any task attribute (content, description, due date, priority) |
| 52 | * Example: "Update meeting task to be due next Monday" |
| 53 | |
| 54 | ### todoist_complete_task |
| 55 | Mark tasks as complete using natural language search: |
| 56 | * Find tasks by partial name match |
| 57 | * Confirm completion status |
| 58 | * Example: "Mark the documentation task as complete" |
| 59 | |
| 60 | ### todoist_delete_task |
| 61 | Remove tasks using natural language search: |
| 62 | * Find and delete tasks by name |
| 63 | * Confirmation messages |
| 64 | * Example: "Delete the PR review task" |
| 65 | |
| 66 | ## Setup |
| 67 | |
| 68 | ### Getting a Todoist API Token |
| 69 | 1. Log in to your Todoist account |
| 70 | 2. Navigate to Settings → Integrations |
| 71 | 3. Find your API token under "Developer" |
| 72 | |
| 73 | ### Usage with Claude Desktop |
| 74 | |
| 75 | Add to your `claude_desktop_config.json`: |
| 76 | |
| 77 | ```json |
| 78 | { |
| 79 | "mcpServers": { |
| 80 | "todoist": { |
| 81 | "command": "npx", |
| 82 | "args": ["-y", "@abhiz123/todoist-mcp-server"], |
| 83 | "env": { |
| 84 | "TODOIST_API_TOKEN": "your_api_token_here" |
| 85 | } |
| 86 | } |
| 87 | } |
| 88 | } |
| 89 | ``` |
| 90 | |
| 91 | ## Example Usage |
| 92 | |
| 93 | ### Creating Tasks |
| 94 | ``` |
| 95 | "Create task 'Team Meeting'" |
| 96 | "Add task 'Review PR' due tomorrow at 2pm" |
| 97 | "Create high priority task 'Fix bug' with description 'Critical performance issue'" |
| 98 | ``` |
| 99 | |
| 100 | ### Getting Tasks |
| 101 | ``` |
| 102 | "Show all my tasks" |
| 103 | "List tasks due today" |
| 104 | "Get high priority tasks" |
| 105 | "Show tasks due this week" |
| 106 | ``` |
| 107 | |
| 108 | ### Updating Tasks |
| 109 | ``` |
| 110 | "Update documentation task to be due next week" |
| 111 | "Change priority of bug fix task to urgent" |
| 112 | "Add description to team meeting task" |
| 113 | ``` |
| 114 | |
| 115 | ### Completing Tasks |
| 116 | ``` |
| 117 | "Mark the PR review task as complete" |
| 118 | "Complete the documentation task" |
| 119 | ``` |
| 120 | |
| 121 | ### Deleting Tasks |
| 122 | ``` |
| 123 | "Delete the PR review task" |
| 124 | "Remove meeting prep task" |
| 125 | ``` |
| 126 | |
| 127 | ## Development |
| 128 | |
| 129 | ### Building from source |
| 130 | ```bash |
| 131 | # Clone the repository |
| 132 | git clone https://github.com/abhiz123/todoist-mcp-server.git |
| 133 | |
| 134 | # Navigate to directory |
| 135 | cd todoist-mcp-server |
| 136 | |
| 137 | # Install dependencies |
| 138 | npm install |
| 139 | |
| 140 | # Build the project |
| 141 | npm run build |
| 142 | ``` |
| 143 | |
| 144 | ## Contributing |
| 145 | Contributions are welcome! Feel free to submit a Pull Request. |
| 146 | |
| 147 | ## License |
| 148 | This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. |
| 149 | |
| 150 | ## Issues and Support |
| 151 | If you encounter any issues or need suppor |
People who liked this also viewed
6 picksType
- excel-mcpA Model Context Protocol (MCP) server for working with Excel (.xlsx) files without requiring Microsoft Excel. Enables AI assistants to create, read, modify, and format spreadsheets using openpyxl, fully in Python and cross-platform.MCP ServersOct 2025
- memories-with-lessons-mcp-serverI enhance the existing memory mcp server from the official mcp github, so big thanks and credits for creating thisMCP ServersFeb 2025
- anytype-mcpAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.MCP ServersJul 2026
- mcp-server-kubernetesMCP Server for kubernetes management commandsMCP ServersJul 2026
- thoughtboxThoughtbox is an intention ledger for agents. Evaluate AI's decisions against its decision-making.MCP ServersJul 2026
- google-drive-mcpA Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.MCP ServersJul 2026
