todoist-mcp

What it does

This MCP server bridges Claude and other AI assistants with Todoist, enabling natural language task and project management. It provides full access to the Todoist REST API v2 and Sync API, allowing you to create, read, update, and delete tasks, projects, sections, labels, and comments entirely through conversational commands. On startup, it automatically loads your existing projects and labels into the AI's context, reducing the need for explicit tool calls.

Who it's for

Claude users managing their work in Todoist, particularly those who prefer conversational input to manual clicking. Engineers and knowledge workers who want their AI assistant to help organize, prioritize, and track tasks as part of a broader workflow.

Common use cases

• Query tasks due today or matching Todoist filter syntax (e.g., "overdue", "P1 | P2", "#Work & @urgent")
• Create new tasks with attributes (due date, priority, section, assignee) via natural language
• Update, close, reopen, or move existing tasks without leaving the chat
• Create and organize projects and sections for ongoing work
• Add comments to tasks for context or collaboration notes

Setup pitfalls

• Todoist API token is required: sign into Todoist, navigate to Settings → Integrations → Developer, and copy your token. This is a secret — treat it as a password.
• The API_KEY environment variable must be set in your MCP config; the server will not function without it.
• No CI pipeline is present in the repository. Verify compatibility with your Claude version before deployment.
• The server requires filesystem write permissions and makes external HTTP calls to Todoist; isolate it appropriately if running in a restricted environment.