Todoist MCP Server Extended

Todoist MCP Server Extended

Claude、または工夫次第であらゆるMCP互換LLMとTodoistを連携させ、MCPツールを通じて自然言語でタスクを管理できるようにするMCP（Model Context Protocol）サーバーの実装です。このサーバーのツールを使うと、日常的な言葉でClaudeからTodoistのタスク、プロジェクト、セクション、ラベルを操作できます。また、LLMのワークフロー効率を最適化しています。

機能の概要

• タスク管理：日常的な言葉でタスクの作成、更新、完了、削除を行えます
• ラベル管理：個人用ラベルやタスクラベルを作成、更新、管理できます
• プロジェクト管理：Todoistプロジェクトを作成、更新、管理できます
• セクションの整理：プロジェクト内のセクションを作成、管理できます
• スマート検索：名前の一部に一致するタスクやラベルを検索できます
• 柔軟なフィルタリング：プロジェクト、セクション、期限、優先度、ラベルでタスクを絞り込めます
• 詳細なタスク情報：説明、期限、優先度、プロジェクトやセクションへの割り当てに対応しています
• 一括操作：ツールには一括操作のサポートと、LLMワークフローで効率的に使用するためのカスタムパラメーターが組み込まれています

利用可能なツールとその使い方の一覧については、tools.mdを参照してください。

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

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

より詳細なインストールガイドは、How-to Guide.を参照してください。

Smithery経由でのインストール

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

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

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

最後のパラメーターを--client clineまたは--client windsurfに変更すると、clineまたはwindsurfにも対応します

npm経由でのインストール

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

    npm install -g @chrusic/todoist-mcp-server-extended

セットアップ

Todoist APIトークンの取得

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

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

MCPサーバーとAPIトークンをClaude Desktopクライアントに追加

1. claude_desktop_config.jsonファイルの"mcpServers":{ }:の間に、次のJSONスニペットを貼り付けます。

   "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 DesktopクライアントがMCPサーバーを起動し、ツールを読み込みます。

使用例

Claude に尋ねる際の簡単な提案です。Claude にツールを使わせるには、かなり直接的に指示する必要がある場合があることに注意してください。

• 「MCP ツール todoist_get_tasks を使って、今日のタスクをすべて一覧表示してください。」
• 「プロジェクト『Work』のセクション『To Do』に『Review PR』というタスクを作成してください。」
• 「プロジェクト『Work』のタスク『Review PR』にラベル『Important』を追加してください。」
• 「プロジェクト『Work』でラベル『Important』が付いたタスクをすべて表示してください。」
• 「タスク『Documentation』をセクション『In Progress』に移動してください。」
• 「ドキュメント作成のタスクを完了としてマークしてください。」
• 「町へ買い物に行くので、今日できる一覧表示されたタスクについて、いくつか提案してください。」
• 「タスク X を小さなサブタスクに分割し、期限 x、y、z を設定してください。」

貢献

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

ライセンス

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

問題とサポート

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