Todoist MCP Server

🚀 Todoist MCP サーバー

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

🚀 クイックスタート

このTodoist MCPサーバーは、Claudeと連携して自然言語でのタスク管理を可能にします。以下のセクションでは、その機能、インストール方法、使用方法などを詳しく説明します。

✨ 主な機能

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

📦 インストール

Smitheryを通じたインストール

Smithery を通じてClaude Desktop用のTodoist MCP Serverを自動インストールするには、以下のコマンドを実行します。

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

手動インストール

手動でインストールするには、以下のコマンドを実行します。

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

📚 ドキュメント

ツールの説明

todoist_create_task

様々な属性を持つ新しいタスクを作成します。

• 必須：content（タスクのタイトル）
• オプション：description、due_date、priority_level（1-4）
• 例："Create task 'Team Meeting' with description 'Weekly sync' due tomorrow"

todoist_get_tasks

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

• 期限、優先度、またはプロジェクトで絞り込みます。
• 自然言語での日付フィルタリングが可能です。
• 結果の制限がオプションです。
• 例："Show high priority tasks due this week"

todoist_update_task

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

• 部分的な名称一致でタスクを検索します。
• タスクの属性（内容、説明、期限、優先度）を更新できます。
• 例："Update meeting task to be due next Monday"

todoist_complete_task

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

• 名称でタスクを検索し、削除します。
• 完了状態を確認します。
• 例："Mark the documentation task as complete"

todoist_delete_task

自然言語での検索を使用してタスクを削除します。

• 名称でタスクを検索し、削除します。
• 確認メッセージを表示します。
• 例："Delete the PR review 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_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用例

基本的な使用法

タスクの作成

todoist_create_task --content "完成项目报告" --description "包含所有最新数据的详细报告"

タスクの取得

todoist_get_tasks --due_date "2023-10-31"

タスクの更新

todoist_update_task --task_id 123 --priority_level 2

タスクの完了

todoist_complete_task --task_id 456

タスクの削除

todoist_delete_task --task_id 789

🔧 開発情報

このプロジェクトに貢献したり、開発を行う場合は、GitHubリポジトリ を参照してください。

🤝 貢献ガイド

貢献を歓迎します！プルリクエストを提出するか、GitHub で問題を報告してください。

📄 ライセンス

このプロジェクトは MIT License に従っています。

❓ 問題サポート

問題が発生した場合は、GitHub Issues を訪問するか、メンテナーに連絡してください。