Todoist Mcp

Todoist MCP サーバー

Todoist 用の Model Context Protocol（MCP）サーバーです。Claude Desktop やその他の MCP 対応クライアントから、高度なタスク管理とプロジェクト管理を行えます。

要件

• Node.js（v18 以上を推奨）
• npm または yarn
• Todoist アカウント
• Todoist API トークン（https://todoist.com/prefs/integrations を参照）

機能

• タスクの一覧表示、作成、更新、完了、再開、削除
• プロジェクトの一覧表示、作成、更新、アーカイブ、アーカイブ解除、削除
• セクションの一覧表示、作成、更新、削除
• ラベルの一覧表示、作成、更新、削除
• コメントの一覧表示、作成、更新、削除
• 共有ラベルの管理
• プロジェクトの共同作業者の取得

すべての機能

• タスク：一覧表示、取得、作成、更新、完了、再開、削除
• プロジェクト：一覧表示、取得、作成、更新、アーカイブ、アーカイブ解除、削除
• セクション：一覧表示（プロジェクト別）、取得、作成、更新、削除
• ラベル：一覧表示、取得、作成、更新、削除、共有ラベルの管理
• コメント：一覧表示（タスク／プロジェクト別）、取得、作成、更新、削除
• 共同作業者：プロジェクトの共同作業者の一覧表示

インストール

Claude Desktop 用（JSON）

npm パッケージとして公開されている場合は、Claude Desktop の設定で npx を使って直接実行できます。

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

• 上記のとおり TODOIST_API_TOKEN を設定します。

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/todoist-mcp.git
   cd todoist-mcp
   

2. 依存関係をインストールします。

   npm install
   # or
   yarn install
   

3. プロジェクトをビルドします。

   npm run build
   # or
   yarn build
   

4. Todoist API トークンを環境変数として設定します（上記を参照）。
5. ビルドしたサーバーを実行します。

   node dist/server.js
   

6. 設定ファイルに以下を追加して、ローカルビルドを使用するよう Claude Desktop を設定します。

   {
     "mcpServers": {
       "todoist": {
         "command": "node",
         "args": [
           "/path/to/todoist-mcp/dist/server.js"
         ],
         "env": {
           "TODOIST_API_TOKEN": "your_todoist_token"
         }
       }
     }
   }
   

使用例

• 優先度の高いタスクを取得する：

  「優先度の高いタスクを表示してください。」

• ラベルを作成して分類する：

  「タスク用のラベルを作成し、プロジェクト別または緊急度別に分類してください。」

• セクション別にタスクを整理する：

  「ラベルが『urgent』のタスクをすべて『Today』セクションに移動してください。」

• プロジェクト管理：

  「『Personal Growth』という新しいプロジェクトを作成し、『Reading List』というセクションを追加してください。」

• 共同作業者の確認：

  「『Team Launch』プロジェクトの共同作業者をすべて一覧表示してください。」

• コメント管理：

  「『Prepare slides』タスクに、『Remember to include Q2 results.』という内容のコメントを追加してください。」

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE を参照してください。