Todoist MCP Server

What is Todoist MCP Server?

The Todoist MCP Server connects Claude with Todoist via the Model Context Protocol, enabling complete task and project management through natural language commands. It provides 19 MCP tools to manage tasks, projects, sections, labels, reminders, comments, and more.

How to use Todoist MCP Server?

Install via one-click by downloading the .mcpb file from the latest release and double-clicking it on Claude Desktop, then entering your Todoist API token. Alternatively, add it manually to your MCP client configuration (claude_desktop_config.json or ~/.claude.json) with npx @greirson/mcp-todoist and set the TODOIST_API_TOKEN environment variable. Enable dry-run mode by adding DRYRUN=true to the environment to simulate operations without real changes.

Key features of Todoist MCP Server

• 19 MCP tools for complete Todoist management
• Task creation, update, delete, complete, reopen with priorities and due dates
• Bulk operations on multiple tasks efficiently
• Subtask hierarchy with completion tracking
• Projects, sections, labels, filters, and reminders
• Natural language quick add with Todoist parsing
• Dry-run mode to test operations without mutation

Use cases of Todoist MCP Server

• Manage your entire Todoist workspace through Claude chat
• Run bulk updates or completions on many tasks at once
• Test new automations or workflows safely with dry-run mode
• Explore the Todoist API and learn tool capabilities without risk
• Automate project setup and recurring task creation

FAQ from Todoist MCP Server

How do I install the Todoist MCP Server?

Use the one-click .mcpb file from the latest GitHub release, or add the server manually to your MCP client configuration with npx @greirson/mcp-todoist and your Todoist API token.

What is dry-run mode and how do I enable it?

Dry-run mode simulates all mutation operations (create, update, delete) without making real changes to your Todoist data. Enable it by setting the environment variable DRYRUN=true in your MCP server configuration.

What common issues may I encounter?

Connection errors often stem from an incorrect or missing TODOIST_API_TOKEN. Also verify the configuration file path is correct for your operating system and that the @greirson/mcp-todoist package is installed globally.

How does the Quick Add tool work?

Quick Add parses natural language text similar to the Todoist app. Use syntax like due dates, #ProjectName for projects, @label for labels, p1–p4 for priority, //description at the end, and more.

What tools does the Todoist MCP Server provide?

The server offers 19 tools covering tasks, subtasks, bulk operations, projects, sections, labels, comments, reminders, filters, collaboration, user stats, activity logs, backups, notes, shared labels, and utility functions like testing and duplicate detection.