Todoist MCP Server

Todoist MCP Server とは？

この Todoist MCP サーバーは、abhiz123 が開発したコミュニティ製の小さな MCP サーバーで、Claude を Todoist アカウントに接続します。Todoist の API トークンで認証すると、タスクの作成・一覧表示・更新・完了・削除を自然言語で行えます。

Node.js でローカルに動作し、npm で @abhiz123/todoist-mcp-server として公開されており、5 つのタスク用ツールを提供します。MIT ライセンスで、Todoist の開発元である Doist の製品ではありません。Doist はホスト型エンドポイントを備えた公式の Todoist MCP サーバーを別に公開しています（比較は後述）。このコミュニティ版リポジトリの最終更新は 2025 年 4 月です。

Todoist MCP Server の使い方

前提条件：Node.js（npx/npm 用）、MCP クライアント、Todoist の API トークン。

Todoist の API トークンを取得する：

1. Todoist にログインします。
2. Settings > Integrations を開きます。
3. 「Developer」セクションにある API トークンをコピーします。

トークンは環境変数 TODOIST_API_TOKEN に設定します。トークンを持つ人は誰でもあなたの Todoist アカウントを操作できるため、共有したりリポジトリにコミットしたりする設定ファイルには含めないでください。

Claude Desktop

claude_desktop_config.json に次を追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Smithery を使って Claude Desktop に自動インストールすることもできます。

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

または、パッケージをグローバルにインストールします。

npm install -g @abhiz123/todoist-mcp-server

その他の MCP クライアント

README に記載されているのは Claude Desktop だけです。標準的な stdio サーバーなので、Cursor や VS Code などのクライアントでも、サーバーの env ブロックに TODOIST_API_TOKEN を設定して同じ npx -y @abhiz123/todoist-mcp-server コマンドを実行できます。Claude Code、Cursor、VS Code については、公式の Doist サーバー（後述）に設定手順が文書化されています。

ソースからビルドする

git clone https://github.com/abhiz123/todoist-mcp-server.git
cd todoist-mcp-server
npm install
npm run build

Todoist MCP Server の主な機能

• 自然言語のリクエストで Todoist のタスクを作成・更新・完了・削除。
• スマートなタスク検索：更新・完了・削除はタスク名の部分一致で対象を見つけるため、タスク ID は不要。
• 期限、優先度、プロジェクトでタスクを絞り込み。自然言語での日付指定や、件数の上限指定にも対応。
• タスクの説明、期限、1〜4 の優先度に対応。
• 各操作のあとに分かりやすいエラーメッセージと確認を返す。
• 軽量でローカル動作：npm パッケージ 1 つと環境変数 1 つだけ。

Todoist MCP Server のツール

サーバーが公開するツールは 5 つで、すべてタスクに関するものです。

• 作成：todoist_create_task は必須の content（タイトル）と、任意の説明・期限・優先度を受け取ります。
• 取得：todoist_get_tasks は期限、優先度、プロジェクトで絞り込んだタスクを取得し、件数の上限も指定できます。
• 変更：todoist_update_task は部分一致でタスクを見つけ、内容、説明、期限、優先度を変更します。
• 完了・削除：todoist_complete_task は一致したタスクを完了にし、todoist_delete_task は削除します。

プロジェクト、ラベル、セクション、コメント用のツールはありません。リポジトリにはプロジェクト対応を求める未解決の issue があります。

Todoist MCP Server のユースケース

• 会話の途中でタスクを登録：「Add task 'Review PR' due tomorrow at 2pm.」
• 1 日の計画：「今日が期限のタスクを一覧にして」「今週が期限の優先度の高いタスクを見せて」。
• アプリを開かずに予定変更：「ドキュメントのタスクの期限を来週にして。」
• 優先度の見直し：「バグ修正タスクの優先度を緊急にして。」
• 片付け：「PR レビューのタスクを完了にして」「会議準備のタスクを削除して」。
• Claude が要約したばかりの会議メモを、個別の Todoist タスクに変換する。

Todoist MCP Server と代替ツールの比較

Doist 公式の Todoist MCP server は https://ai.todoist.net/mcp（Streamable HTTP）でホストされており、OAuth でサインインするため、設定に API トークンを置く必要がありません。活発にメンテナンスされており、Claude Desktop、Claude Code（claude mcp add --transport http todoist https://ai.todoist.net/mcp）、Cursor、VS Code の手順が文書化されています。npx @doist/todoist-mcp でローカル実行も可能です。幅広い機能とベンダーのサポートを求めるなら公式サーバー、基本的なタスク管理だけをトークンベースの最小構成でローカルに置きたいなら abhiz123 のサーバーが向いています。チーム向けのプロジェクト管理ツールなら Asana MCP Server や Trello MCP Server を参照してください。

Todoist MCP Server のトラブルシューティング

• 認証エラー：サーバーの env ブロックに TODOIST_API_TOKEN が設定され、Settings > Integrations > Developer のトークンと一致しているか確認します。
• 別のタスクが更新されてしまう：部分一致で検索するため、似た名前のタスクが複数ある場合はタイトルのより具体的な部分を指定します。
• todoist_get_tasks が 400 エラーを返す：リポジトリの issue でユーザーから報告されています。より単純な絞り込み条件を試すか、活発にメンテナンスされている公式の Doist サーバーを検討してください。
• Claude Desktop にサーバーが表示されない：JSON の書式を確認し、npx が使えるよう Node.js がインストールされていることを確かめてから、Claude Desktop を完全に再起動します。