Todoist MCP Server

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 を直接使用できます。

• 示されているように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" } } } }

使用例

• 最優先タスクを取得します。

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

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

  「タスクにラベルを作成し、プロジェクトまたは緊急度によって分類します。」

• タスクをセクションごとに整理します。

  「「緊急」というラベルが付いたすべてのタスクを「今日」セクションに移動します。」

• プロジェクト管理：

  「「個人の成長」という新しいプロジェクトを作成し、「読書リスト」セクションを追加します。」

• 共同作業者の概要:

  「プロジェクト「Team Launch」のすべての共同作業者を一覧表示します。」

• コメント管理:

  「「スライドを準備する」タスクに、「第 2 四半期の結果を忘れずに含めてください」という内容のコメントを追加します。」

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はライセンスをご覧ください。