MCP Todoist

- MCPサーバー: Node.js + TypeScript
- プロトコル: MCP (Model Context Protocol) stdio transport
- 外部API: Todoist REST API
- 言語: TypeScript
- ランタイム: tsx

├── フロントエンド (Next.js 14) │ ├── React Server Components │ ├── Client Components │ └── API Routes ├── MCP Server Layer │ ├── Protocol Handler │ ├── Todoist API Adapter │ └── Tool Registry ├── バックエンド (Convex) │ ├── Database Functions │ ├── Mutations │ ├── Queries │ └── Actions └── 外部API └── Todoist API

- MCP Protocol Handler (stdio transport)
- Todoist APIクライアント
- MCPツール実装

- todoist_get_tasks- タスク一覧取得
- todoist_create_task- タスク作成
- todoist_update_task- タスク更新
- todoist_close_task- タスク完了
- todoist_get_projects- プロジェクト一覧取得
- todoist_create_project- プロジェクト作成
- todoist_update_project- プロジェクト更新
- todoist_delete_project- プロジェクト削除

- 公開ツール:todoist_get_tasks,todoist_create_task,todoist_update_task,todoist_close_task,todoist_get_projects,todoist_move_task
- 非公開ツール:todoist_create_project,todoist_update_project,todoist_delete_project

📖詳細: ツールの可視性設定の詳細についてはTOOL_VISIBILITY.mdを参照してください。

cd packages/mcp-server npm run build cd ../..

# タスクリスト取得のテスト echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todoist_get_tasks","arguments":{}}}' | TODOIST_API_TOKEN=your-api-token npx tsx script/run-mcp-server.ts

# リポジトリをクローン（または既存プロジェクトの場合はスキップ） git clone <repository-url> cd mcp-todoist # 依存関係のインストール npm install # MCPサーバーのビルド cd packages/mcp-server npm run build cd ../..

- Todoist App Consoleにアクセス
- 「Create a new app」をクリック
- アプリ名を入力（例：「MCP Todoist Integration」）
- 「Create app」をクリック
- 表示されたAPI tokenをコピー（例：61dae250699e84eb85b9c2ab9461c0581873566d）

# 現在のディレクトリパスを取得 CURRENT_DIR=$(pwd) # Cursor AI設定ディレクトリを作成 mkdir -p ~/.cursor # MCP設定ファイルを自動生成 cat > ~/.cursor/mcp.json << EOF { "mcpServers": { "mcp-todoist": { "command": "tsx", "args": ["$CURRENT_DIR/script/run-mcp-server.ts"], "env": { "TODOIST_API_TOKEN": "YOUR_TODOIST_API_TOKEN_HERE" } } } } EOF echo "✅ MCP設定ファイルを作成しました: ~/.cursor/mcp.json" echo "⚠️ 次のステップ: YOUR_TODOIST_API_TOKEN_HERE を実際のAPIトークンに置き換えてください"

# macOS/Linux ls -la ~/.cursor/ # Windowsの場合: %USERPROFILE%\.cursor\

# macOS/Linux nano ~/.cursor/mcp.json # または code ~/.cursor/mcp.json

{ "mcpServers": { "mcp-todoist": { "command": "tsx", "args": ["/REPLACE_WITH_YOUR_PROJECT_PATH/script/run-mcp-server.ts"], "env": { "TODOIST_API_TOKEN": "REPLACE_WITH_YOUR_API_TOKEN" } } } }

- プレースホルダーを置き換え:

- /REPLACE_WITH_YOUR_PROJECT_PATH→ 実際のプロジェクトパス
- REPLACE_WITH_YOUR_API_TOKEN→ 実際のTodoist APIトークン

# 設定ファイルの内容を確認 cat ~/.cursor/mcp.json # MCPサーバーが正常に動作するかテスト echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | TODOIST_API_TOKEN=your-actual-token tsx script/run-mcp-server.ts

- ⌘+,(Mac) またはCtrl+,(Windows) で設定を開く
- "MCP" を検索
- mcp-todoistサーバーが表示され、緑のインジケーターが点灯していることを確認

- ⌘+Lでチャットを開く
- 「Todoistからタスクリストを取得して」と入力
- MCPツールが自動実行され、タスクリストが表示されることを確認

AIアシスタントがこのREADMEを読んで自動セットアップを実行する場合の手順:

node --version # 18+ であることを確認 npm --version # インストールされていることを確認

# プロジェクトディレクトリに移動していることを確認 pwd # 依存関係インストール npm install # MCPサーバービルド cd packages/mcp-server && npm run build && cd ../..

CURRENT_DIR=$(pwd) echo "プロジェクトパス: $CURRENT_DIR"

mkdir -p ~/.cursor cat > ~/.cursor/mcp.json << EOF { "mcpServers": { "mcp-todoist": { "command": "tsx", "args": ["$CURRENT_DIR/script/run-mcp-server.ts"], "env": { "TODOIST_API_TOKEN": "PLACEHOLDER_FOR_USER_TOKEN" } } } } EOF

✅ MCP設定ファイルを作成しました！ 📝 次の手順を完了してください： 1. Todoist API トークンを取得: https://todoist.com/app_console 2. 以下のコマンドで設定ファイルを編集: nano ~/.cursor/mcp.json 3. "PLACEHOLDER_FOR_USER_TOKEN" を実際のAPIトークンに置き換え 4. Cursor AI を再起動 5. チャットで「Todoistからタスクリストを取得して」とテスト

echo "設定ファイルの内容:" cat ~/.cursor/mcp.json echo "" echo "APIトークンを設定後、以下でテスト:" echo 'echo \'{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todoist_get_tasks","arguments":{}}}\' | TODOIST_API_TOKEN=your-token tsx script/run-mcp-server.ts'

「Todoistからタスクリストを取得して」 「新しいタスク『プロジェクト資料作成』を優先度2で作成して」 「プロジェクト一覧を表示して」 「タスクID 123456789 を完了にして」

# 初期化 echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | TODOIST_API_TOKEN=your-token tsx script/run-mcp-server.ts # ツール一覧 echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | TODOIST_API_TOKEN=your-token tsx script/run-mcp-server.ts # タスク作成 echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"todoist_create_task","arguments":{"content":"テストタスク","priority":2}}}' | TODOIST_API_TOKEN=your-token tsx script/run-mcp-server.ts

- cd packages/mcp-server && npm run buildでビルドを実行

- Cursor AIを完全に再起動
- ~/.cursor/mcp.jsonのパスが正しいか確認
- 環境変数TODOIST_API_TOKENが設定されているか確認

- APIトークンが有効か確認
- Todoist API ドキュメントで制限事項を確認

- GitHub:https://github.com/kentaroh7777/mcp-todoist
- MCP Protocol:https://modelcontextprotocol.io
- Todoist API:https://developer.todoist.com
- Fork the repository
- Create your feature branch (git checkout -b feature/AmazingFeature)
- Commit your changes (git commit -m 'Add some AmazingFeature')
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem