Todoist MCP Server

Name: Todoist MCP Server
Author: greirson

@greirson

リポジトリ

Todoist MCP Server について

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

基本情報

カテゴリ

生産性

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

greirson

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.