TaskWarrior MCP Server

TaskWarrior MCP サーバー

TaskWarrior の操作に対応した Model Context Protocol（MCP）を実装する Node.js サーバーです。

特長

• 保留中のタスクを表示
• プロジェクトとタグでタスクを絞り込み
• 説明、期限、優先度、プロジェクト、タグを指定してタスクを追加
• タスクを完了としてマーク

注意：ローカルの task バイナリを実行するため、TaskWarrior のインストールと設定が必要です。

警告

現在、安定しない識別子であるタスクの id を使用しています。TaskWarrior は、 タスクの追加や削除時にタスクの番号を振り直すことがあります。今後はタスクの UUID を 使用するなど、より慎重に処理する必要があります。

API

ツール

• get_next_tasks

  • 保留中のタスク一覧を取得
  • 任意のフィルター：
    • project：プロジェクト名で絞り込み
    • tags：1 つ以上のタグで絞り込み

• add_task

  • TaskWarrior に新しいタスクを追加
  • 必須：
    • description：タスクの説明文
  • 任意：
    • due：期限（ISO タイムスタンプ）
    • priority：優先度（"H"、"M"、"L" のいずれか）
    • project：プロジェクト名（小文字、ドット区切り）
    • tags：タグの配列（小文字）

• mark_task_done

  • タスクを完了としてマーク
  • 必須：
    • identifier：タスク ID または UUID

Claude Desktop での使用方法

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

{
  "mcpServers": {
    "taskwarrior": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-taskwarrior"
      ]
    }
  }
}

インストール

npm install -g mcp-server-taskwarrior

TaskWarrior（task）がシステムにインストールされ、設定されていることを確認してください。

使用例：

• 現在の仕事のタスクは何ですか？
  • 実行内容：task project:work next
• TODO：妹に電話する（優先度：高）
  • 実行内容：task add priority:H Call my sister
• わかりました、妹に電話しました
  • 実行内容：task done 1

ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。