Skip to content
Back to search

todoist-mcp-server

MCP server for Todoist integration enabling natural language task management with Claude

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/abhiz123--todoist-mcp-server/badge.svg)](/listings/abhiz123--todoist-mcp-server)

HTML

<a href="/listings/abhiz123--todoist-mcp-server"><img src="/api/listings/abhiz123--todoist-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install Todoist MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@abhiz123/todoist-mcp-server):

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Manual Installation

npm install -g @abhiz123/todoist-mcp-server

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 151 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Todoist MCP Server
  2. [![smithery badge](https://smithery.ai/badge/@abhiz123/todoist-mcp-server)](https://smithery.ai/server/@abhiz123/todoist-mcp-server)
  3. 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.
  4. <a href="https://glama.ai/mcp/servers/fhaif4fv1w">
  5. <img width="380" height="200" src="https://glama.ai/mcp/servers/fhaif4fv1w/badge" alt="Todoist Server MCP server" />
  6. </a>
  7. ## Features
  8. * **Natural Language Task Management**: Create, update, complete, and delete tasks using everyday language
  9. * **Smart Task Search**: Find tasks using partial name matches
  10. * **Flexible Filtering**: Filter tasks by due date, priority, and other attributes
  11. * **Rich Task Details**: Support for descriptions, due dates, and priority levels
  12. * **Intuitive Error Handling**: Clear feedback for better user experience
  13. ## Installation
  14. ### Installing via Smithery
  15. To install Todoist MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@abhiz123/todoist-mcp-server):
  16. ```bash
  17. npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
  18. ```
  19. ### Manual Installation
  20. ```bash
  21. npm install -g @abhiz123/todoist-mcp-server
  22. ```
  23. ## Tools
  24. ### todoist_create_task
  25. Create new tasks with various attributes:
  26. * Required: content (task title)
  27. * Optional: description, due date, priority level (1-4)
  28. * Example: "Create task 'Team Meeting' with description 'Weekly sync' due tomorrow"
  29. ### todoist_get_tasks
  30. Retrieve and filter tasks:
  31. * Filter by due date, priority, or project
  32. * Natural language date filtering
  33. * Optional result limit
  34. * Example: "Show high priority tasks due this week"
  35. ### todoist_update_task
  36. Update existing tasks using natural language search:
  37. * Find tasks by partial name match
  38. * Update any task attribute (content, description, due date, priority)
  39. * Example: "Update meeting task to be due next Monday"
  40. ### todoist_complete_task
  41. Mark tasks as complete using natural language search:
  42. * Find tasks by partial name match
  43. * Confirm completion status
  44. * Example: "Mark the documentation task as complete"
  45. ### todoist_delete_task
  46. Remove tasks using natural language search:
  47. * Find and delete tasks by name
  48. * Confirmation messages
  49. * Example: "Delete the PR review task"
  50. ## Setup
  51. ### Getting a Todoist API Token
  52. 1. Log in to your Todoist account
  53. 2. Navigate to Settings → Integrations
  54. 3. Find your API token under "Developer"
  55. ### Usage with Claude Desktop
  56. Add to your `claude_desktop_config.json`:
  57. ```json
  58. {
  59. "mcpServers": {
  60. "todoist": {
  61. "command": "npx",
  62. "args": ["-y", "@abhiz123/todoist-mcp-server"],
  63. "env": {
  64. "TODOIST_API_TOKEN": "your_api_token_here"
  65. }
  66. }
  67. }
  68. }
  69. ```
  70. ## Example Usage
  71. ### Creating Tasks
  72. ```
  73. "Create task 'Team Meeting'"
  74. "Add task 'Review PR' due tomorrow at 2pm"
  75. "Create high priority task 'Fix bug' with description 'Critical performance issue'"
  76. ```
  77. ### Getting Tasks
  78. ```
  79. "Show all my tasks"
  80. "List tasks due today"
  81. "Get high priority tasks"
  82. "Show tasks due this week"
  83. ```
  84. ### Updating Tasks
  85. ```
  86. "Update documentation task to be due next week"
  87. "Change priority of bug fix task to urgent"
  88. "Add description to team meeting task"
  89. ```
  90. ### Completing Tasks
  91. ```
  92. "Mark the PR review task as complete"
  93. "Complete the documentation task"
  94. ```
  95. ### Deleting Tasks
  96. ```
  97. "Delete the PR review task"
  98. "Remove meeting prep task"
  99. ```
  100. ## Development
  101. ### Building from source
  102. ```bash
  103. # Clone the repository
  104. git clone https://github.com/abhiz123/todoist-mcp-server.git
  105. # Navigate to directory
  106. cd todoist-mcp-server
  107. # Install dependencies
  108. npm install
  109. # Build the project
  110. npm run build
  111. ```
  112. ## Contributing
  113. Contributions are welcome! Feel free to submit a Pull Request.
  114. ## License
  115. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  116. ## Issues and Support
  117. If you encounter any issues or need support, please file an issue on the [GitHub repository](https://github.com/abhiz123/todoist-mcp-server/issues).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.