Todoist MCP

🚀 Todoist MCP サーバー

Todoist 用の Model Context Protocol (MCP) サーバーです。Claude Desktop やその他の MCP 互換クライアントを通じて、高度なタスクとプロジェクト管理をサポートします。

🚀 クイックスタート

Todoist MCP サーバーを使用することで、Claude Desktop やその他の MCP 互換クライアントを通じて、Todoist のタスクとプロジェクトを高度に管理できます。

✨ 主な機能

• タスクの一覧表示、作成、更新、完了、再開、削除
• プロジェクトの一覧表示、取得、作成、更新、アーカイブ、アーカイブ解除、削除
• セクション（sections）のプロジェクト別一覧表示、取得、作成、更新、削除
• ラベルの一覧表示、取得、作成、更新、削除、共有ラベルの管理
• コメントの一覧表示、取得、作成、更新、削除
• 共有ラベルの管理
• プロジェクトの協作者の取得

📦 インストール

必要条件

• Node.js（バージョン v18 以上を推奨）
• npm または yarn
• Todoist アカウント
• Todoist API トークン（https://todoist.com/prefs/integrations を参照）

Claude Desktop（JSON）用のインストール

npm パッケージとして公開されている場合、Claude Desktop の設定で直接使用できます。

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

• TODOIST_API_TOKEN を上記のように設定します。

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/todoist-mcp.git
   cd todoist-mcp
   

2. 依存関係をインストールします。

   npm install
   # または
   yarn install
   

3. プロジェクトをビルドします。

   npm run build
   # または
   yarn build
   

4. Todoist API トークンを環境変数として設定します（上記の通り）。
5. ビルドされたサーバーを実行します。

   node dist/server.js
   

6. ローカルビルドを使用するために、設定ファイルに以下を追加します。

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

💻 使用例

基本的な使用法

• 最優先タスクの取得：

  "Show me my top priority tasks."

• ラベルの作成と分類：

  "Create labels for my tasks and classify them by project or urgency."

• セクション別のタスク整理：

  "Move all tasks with the label 'urgent' to the 'Today' section."

• プロジェクト管理：

  "Create a new project called 'Personal Growth' and add a section 'Reading List'."

• 協作者の一覧表示：

  "List all collaborators for the project 'Team Launch'."

• コメント管理：

  "Add a comment to the task 'Prepare slides' with the content 'Remember to include Q2 results.'"

📄 ライセンス

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