Todoist Mcp Server

What is Todoist MCP Server?

Todoist MCP Server is a Model Context Protocol (MCP) server that connects the Todoist API with AI assistants like Claude. It enables AI assistants to interact with Todoist projects, sections, tasks, and labels, allowing users to manage their productivity workflow through natural language conversations.

How to use Todoist MCP Server?

Obtain a Todoist API token from the Todoist Developer Settings page. Then configure your MCP client to run the server via Docker, setting the TODOIST_API_TOKEN environment variable to your token. The server provides over 30 tools that AI assistants can invoke for managing projects, sections, tasks, labels, and comments.

Key features of Todoist MCP Server

• Full CRUD operations for Todoist projects, sections, tasks, labels, and comments
• Task management including close, reopen, and bulk move operations
• Advanced task filtering using Todoist’s natural language filter syntax
• Comment creation and retrieval on both tasks and projects
• Docker-based deployment with a single environment variable

Use cases of Todoist MCP Server

• Manage Todoist tasks via voice or chat with an AI assistant
• Automate project and section organization through natural language commands
• Bulk move or restructure tasks across projects and sections
• Add comments and labels to tasks without leaving the conversation

FAQ from Todoist MCP Server

What is Todoist MCP Server and what does it integrate with?

It is an MCP server that bridges AI assistants (e.g., Claude) with the Todoist API, enabling conversational management of projects, sections, tasks, labels, and comments.

How do I set up Todoist MCP Server?

You need a Todoist API token (from Todoist Developer Settings) and Docker. Add the provided Docker run configuration to your MCP client’s settings, replacing <your_api_token_here> with your token.

What operations can I perform with Todoist MCP Server?

The server exposes over 30 tools including creating, reading, updating, and deleting projects, sections, tasks, labels, and comments; closing and reopening tasks; moving tasks between projects, sections, or as subtasks; and advanced task filtering.

Are deletion operations reversible?

No. Deletions of projects, sections, tasks, labels, and comments are permanent and cannot be undone. The README explicitly warns that these operations are irreversible.

Does Todoist MCP Server require any additional dependencies?

It runs via Docker; no other runtime or software is mentioned. The only required credential is a Todoist API token.