Todoist MCP Server

@greirson

About Todoist MCP Server

MCP server that connects Claude to Todoist for natural language task and project management with bulk operations

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "@greirson/mcp-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": ""
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

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.

Frequently asked questions

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?

Comments

Basic information

More Productivity MCP servers

FlowyTeam OKR MCP Server

flowy-team

FlowyTeam is a native OKR MCP server. Connect Claude (Desktop, web, mobile), ChatGPT, Claude Code or n8n and your agent can read every objective and key result in your workspace, post check-ins, move key-result progress,

Sitespeak Claude Plugin

sitespeakai

Manage your SiteSpeakAI chatbot from Claude Code - a plugin and MCP server for optimizing chatbots in plain English.

JobYap

JobYap aggregates job postings directly from companies' official careers sites and gives every posting a public discussion thread, with salaries, locations and full descriptions.

My AskAI

Use My AskAI to find product, setup, integration, API, feature, pricing, and troubleshooting information. Search the public knowledge base, read complete documentation and OpenAPI files, and estimate pricing from monthly

twocents

twocents-page

Human feedback for AI agents — remote MCP server at twocents.page/mcp (share_page / get_feedback)