Todoist MCP Server

Todoist MCP サーバー拡張

Claude（または、もし使いこなせればMCP対応のLLM）をTodoistと統合するMCP（モデル・コンテキスト・プロトコル）サーバー実装。MCPツールを使った自然言語によるタスク管理を可能にします。このサーバーのツールにより、Claudeは日常的な言語でTodoistのタスク、プロジェクト、セクション、ラベルを操作できるようになり、LLMのワークフロー効率も最適化されます。

機能の概要

• タスク管理: 日常的な言語を使用してタスクを作成、更新、完了、削除します
• ラベル管理: 個人ラベルとタスクラベルの作成、更新、管理
• プロジェクト管理: Todoist プロジェクトの作成、更新、管理
• セクションの構成: プロジェクト内のセクションを作成および管理します
• スマート検索: 部分的な名前一致を使用してタスクとラベルを検索します
• 柔軟なフィルタリング: プロジェクト、セクション、期日、優先度、ラベルでタスクをフィルタリングします
• 豊富なタスク詳細:説明、期日、優先度、プロジェクト/セクションの割り当てをサポート
• バッチ操作: ツールには、LLMワークフローを効率的に使用するためのバッチ操作サポートとカスタムパラメータが組み込まれています。

利用可能なツールとその使用方法の完全なリストについては、 tools.md を参照してください。

クイックインストールガイド

npm がすでにインストールされていることを前提としています。

より包括的なインストール ガイドについては、「ハウツー ガイド」をご覧ください。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Todoist MCP Server Extended をインストールするには:

1. cmd\pwsh で次のコマンドを実行します。

最後のパラメータを--client clineまたは--client windsurfに変更することで、cline または windsurf とも互換性があります。

npm経由でインストール

1. cmd\pwsh で次のコマンドを実行します。

設定

Todoist APIトークンを取得する

1. Todoistアカウントにログイン
2. Settings → Integrationsへ移動
3. Developerの下でAPIトークンを見つけます
4. Copy API Token押します

Todoist API の詳細については、公式の Todoist API ドキュメントをご覧ください。

MCPサーバーとAPIトークンを追加するClaudeデスクトップクライアント

1. claude_desktop_config.jsonファイルで、次の JSON スニペットを"mcpServers":{ }:
   "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } }
2. すべてをまとめると、次のようになります。
   { "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } } } }
3. その後、Claude デスクトップ クライアントは MCP サーバーを起動し、次回のクライアントの (再) 起動時にツールを読み込みます。

使用例

クロードに何を尋ねるべきか、いくつか簡単な提案があります。ただし、クロードにツールを使ってもらうには、非常に直接的な質問が必要になる場合があることに注意してください。

• 「MCP ツール: todoist_get_tasks を使用して、その日のすべてのタスクを一覧表示します。」
• 「プロジェクトの「作業」セクションの「To Do」にタスク「PR のレビュー」を作成する」
• 「タスク「PR のレビュー」に「重要」というラベルを追加する」
• 「プロジェクト「作業」内のラベル「重要」のタスクをすべて表示」
• 「タスク「ドキュメント」を「進行中」セクションに移動する」
• 「ドキュメントタスクを完了としてマークする」
• 「今日、街に買い物に行くので、実行できるタスクのリストについて、いくつか提案をください。」
• 「タスク X を小さなサブタスクに分割し、期限 x、y、z を追加します。」

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

問題とサポート

問題が発生した場合やサポートが必要な場合は、 GitHub リポジトリに問題を報告してください。