Todoist MCP Server Ext

🚀 拡張版Todoist MCPサーバー

このプロジェクトは、ClaudeとTodoistを完全に統合する包括的なMCP（モデルコンテキストプロトコル）サーバーの実装です。拡張版では、最新のMCP SDK（@doist/todoist-api-typescript@4.0.4）を使用したTodoist APIを完全に活用し、追加機能、互換性の向上、および機能強化が行われています。

拡張版 - kydycodeによって、元の@abhiz123/todoist-mcp-serverからフォークされ、拡張されました。

🚀 クイックスタート

ローカル開発環境のセットアップ

# 拡張版リポジトリをクローンする
git clone https://github.com/kydycode/todoist-mcp-server-ext.git
cd todoist-mcp-server-ext

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

Todoist APIトークンの取得

1. Todoistアカウントにログインします。
2. [設定] → [統合] → [開発者]に移動します。
3. APIトークンをコピーします。

Claude Desktopでの使用方法

claude_desktop_config.jsonに以下を追加します。

オプション1: ローカルでビルドしたバージョンを実行する

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

オプション2: npm/npxを介して実行する（公開版を推奨）

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

オプション3: 最初にグローバルにインストールする

# 拡張版をグローバルにインストールする
npm install -g @kydycode/todoist-mcp-server-ext@latest

# その後、Claude Desktopの設定で使用する
{
  "mcpServers": {
    "todoist-mcp-server": {
      "command": "todoist-mcp-server-ext",
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

✨ 主な機能

🔧 技術的な改善点

• 更新されたTodoist SDK：@doist/todoist-api-typescript@4.0.4を使用しています。
• 更新されたMCP SDK互換性：MCP SDK 0.5.0と互換性があります。
• 強化されたエラーハンドリング：詳細なエラーメッセージを含む包括的なエラーハンドリング。
• 改善されたTypeScriptサポート：より良い型安全性と互換性。
• 最適化されたAPI使用：Todoist APIの効率的な使用で、getTasksByFilterによる強力な検索とmoveTasksによるセマンティックなタスク移動をサポート。
• 改善されたレスポンスフォーマット：タスク、プロジェクト、ラベルのフォーマットを強化し、検索結果にプロジェクト名を含めることで、読みやすさを向上。

✨ 強化されたタスク管理（10のツール）

• 直接IDベースの操作：タスクIDを使用した効率的なタスク操作。
• 包括的なタスク作成：サブタスク、ラベル、プロジェクト、セクション、優先度をサポート。
• クイック追加統合：Todoistのクイック追加を使用した自然言語によるタスク作成。
• 高度なタスク検索：Todoistのフィルタエンジンを使用した強力なキーワード検索（search: your query）。
• タスク移動機能：タスクをプロジェクト、セクション間で移動したり、サブタスクにすることができます。
• タスク状態管理：タスクの完了、再開、およびライフサイクル管理。
• 詳細なタスク出力：検索およびタスク取得操作で、より多くのタスク詳細を返す。

🗂️ 完全なプロジェクト管理（5のツール）

• 完全なプロジェクトCRUD：すべてのプロパティを持つプロジェクトの作成、読み取り、更新、削除。
• サブプロジェクトサポート：階層的なプロジェクト構造を作成することができます。
• プロジェクトカスタマイズ：色、お気に入り、ビュースタイル（リスト/ボード）を設定することができます。
• 強化されたプロジェクトリスト：ページネーションと詳細なフォーマットで、改善されたプロジェクト取得。

📋 セクション管理（4のツール）

• 完全なセクション操作：セクションの作成、読み取り、更新、削除。
• プロジェクト固有のセクション：プロジェクト内のセクションをフィルタリングし、管理する。
• セクションの整理：適切な順序と構造管理。

🏷️ ラベル管理（5のツール）

• 完全なラベルCRUD：ラベルの作成、読み取り、更新、削除。
• ラベルカスタマイズ：名前、色、お気に入り、順序を設定することができます。
• ページネーション付きラベルリスト：すべてのラベルを効率的に取得する。

💬 コメント管理（5のツール）

• 完全なコメントCRUD：タスクおよびプロジェクトに対するコメントの作成、読み取り、更新、削除。
• 添付ファイルサポート：メタデータ付きのファイル添付をコメントに追加する。
• 柔軟なターゲティング：コメントをタスクまたはプロジェクトに添付することができます。
• ページネーション付きコメント取得：コメントスレッドを効率的に閲覧する。

🛠️ 利用可能なツール（合計29）

タスク操作（10のツール）

プロジェクト操作（5のツール）

セクション操作（4のツール）

ラベル操作（5のツール）

コメント操作（5のツール）

💻 使用例

🎯 高度なタスク作成と管理

"Create task 'Team Meeting @Tomorrow #Work p1'"
"Add task 'Fix critical bug +KydyCode @DevProject L:Urgent L:Backend'"
"Quick add: 'Buy milk tomorrow at 2pm #shopping !p1'"
"Move task with ID {task_id} to project {project_id}"
"Search tasks: search: API deployment"

🗂️ プロジェクト、セクション、ラベル、およびコメント管理

"List all my projects"
"Create project 'Q2 Planning' color:blue favorite:true view:board"
"Get sections for project {project_id}"
"Create label 'HighPriority' color:red isFavorite:true"
"List all labels"
"Add comment 'Great progress on this task!' to task {task_id}"
"Get all comments for project {project_id}"
"Update comment {comment_id} with new content"

🆚 拡張版と元のバージョンの比較

🔧 技術詳細

プロジェクト構造

src/
├── index.ts          # すべてのツールを持つメインサーバーの実装
package.json      # 依存関係とスクリプト
tsconfig.json     # TypeScriptの設定
README.md         # このファイル
local-instructions.md # 個人用の公開ガイド
LICENSE
.gitignore
dist/             # コンパイルされたJavaScript出力 (npm run build後)
    ├── index.js
    └── index.d.ts

ソースからのビルド

# 依存関係をインストールする
npm install

# TypeScriptをビルドする
npm run build

# サーバーをテストする (TODOIST_API_TOKENが必要)
# 例: トークンを設定し、ツールリストのリクエストをパイプする
export TODOIST_API_TOKEN="your_actual_todoist_api_token"
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | node dist/index.js

開発用スクリプト

npm run build     # TypeScriptをコンパイルし、出力を実行可能にする
npm run watch     # 変更を監視して再ビルドする (出力を実行可能にしない)
npm run prepare   # 公開前のビルド (ビルドを実行する)

🤝 コントリビューション

コントリビューションは大歓迎です！この拡張版では、以下のコントリビューションを受け付けています。

• 追加のTodoist APIエンドポイント
• 強化されたエラーハンドリングと検証
• パフォーマンス最適化
• ドキュメントの改善
• バグ修正と互換性の更新

問題とプルリクエストは、拡張版リポジトリに提出してください。

📄 ライセンス

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

🙏 クレジット

• 拡張版：kydycode - 機能強化と互換性の向上
• 元の作成者：@abhiz123 - 初期のTodoist MCPサーバーの実装
• MCPプロトコル：Model Context Protocol by Anthropic

🐛 問題とサポート

• 拡張版の問題：GitHub Issues
• 元のリポジトリ：abhiz123/todoist-mcp-server

🔗 関連リンク

• 拡張版リポジトリ：kydycode/todoist-mcp-server-ext
• NPMパッケージ：@kydycode/todoist-mcp-server-ext
• 元のリポジトリ：abhiz123/todoist-mcp-server
• Todoist APIドキュメント
• Model Context Protocol
• Claude Desktop