Abhiz123 Todoist MCP Server

🚀 Todoist MCP サーバー

ClaudeとTodoistを統合したMCP（モデルコンテキストプロトコル）サーバーの実装です。日常会話を使ってタスクを管理できます。このサーバーにより、Claudeが自然言語であなたのTodoistタスクとやり取りできます。

✨ 主な機能

• 自然言語によるタスク管理：日常会話でタスクの作成、更新、完了、削除が可能です。
• スマートなタスク検索：部分的な名前の一致でタスクを検索できます。
• 柔軟なフィルタリング機能：期限、優先度、その他の属性でタスクを絞り込めます。
• 充実したタスク詳細：説明、期限、優先度レベルをサポートしています。
• 直感的なエラー処理：明確なフィードバックにより、ユーザー体験を向上させます。

📦 インストール

npm install -g @abhiz123/todoist-mcp-server

📚 ドキュメント

todoist_create_task

様々な属性を使って新しいタスクを作成します。

• 必須項目：内容（タスクのタイトル）
• オプション項目：説明、期限、優先度レベル（1 - 4）
• 例：「タスク「チーム会議」を作成し、説明「毎週の同期」を付け、明日のタスクとして設定する」

todoist_get_tasks

タスクを検索し、フィルタリングします。

• 期限、優先度、またはプロジェクトで絞り込みます。
• 自然言語での日付指定によるフィルタリングが可能です。
• 結果の件数制限も選択できます。
• 例：「今週の高優先度タスクを表示する」

todoist_update_task

自然言語で検索し、既存のタスクを更新します。

• 部分的な名前の一致でタスクを検索します。
• 任意のタスク属性（内容、説明、期限、優先度）を更新できます。
• 例：「「会議タスク」を来週月曜日までに設定する」

todoist_complete_task

自然言語で検索し、タスクを完了としてマークします。

• 名前でタスクを検索し、削除します。
• 完了状態を確認します。
• 例：「「ドキュメントタスク」を完了としてマークする」

todoist_delete_task

自然言語で検索し、タスクを削除します。

• 名前でタスクを検索し、削除します。
• 確認メッセージを表示します。
• 例：「「コードレビュータスク」を削除する」

🔧 設定

Todoist APIトークンの取得

1. Todoistアカウントにログインします。
2. 設定 → 統合に移動します。
3. 「開発者」セクションでAPIトークンを見つけます。

Claude Desktopとの連携

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

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "ここにあなたのAPIトークンを入力してください"
      }
    }
  }
}

💻 使用例

タスクの作成

「タスク「チーム会議」を作成する」
「タスク「PRレビュー」を追加し、明日のタスクとして設定する」
「高優先度のタスク「バグ修正」を作成し、説明「重要なパフォーマンス問題」を付ける」

タスクの取得

「すべてのタスクを表示する」
「今日までのタスクをリストする」
「高優先度のタスクを取得する」
「今週までの期限付きタスクを表示する」

タスクの更新

「ドキュメントタスクを来週までに設定する」
「バグ修正タスクの優先度を緊急に変更する」
「チーム会議タスクに説明を追加する」

タスクの完了

「PRレビュータスクを完了としてマークする」
「ドキュメントタスクを完了する」

タスクの削除

「コードレビュータスクを削除する」
「会議準備タスクを削除する」

🔨 開発

ソースコードからのビルド

# リポジトリをクローンする
git clone https://github.com/abhiz123/todoist-mcp-server.git

# ディレクトリに移動する
cd todoist-mcp-server

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

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

🤝 コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

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

❓ 問題とサポート

何か問題がある場合やサポートが必要な場合は、GitHubリポジトリに問題を登録してください。