MCP Server Taskwarrior

🚀 タスクワリアー MCP サーバー

Node.js を使用して実装された TaskWarrior 操作のモデルコンテキストプロトコル (MCP) サーバーです。このサーバーを使用することで、TaskWarrior のタスク管理を効率的に行うことができます。

✨ 主な機能

• 未処理のタスクを確認できます。
• プロジェクトやタグに基づいてタスクをフィルタリングできます。
• 説明、期限、優先度、プロジェクト、タグを含む新しいタスクを追加できます。
• タスクを完了としてマークできます。

⚠️ 重要提示

ここではローカルの 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

高優先度で、姉妹に電話するタスクを追加する

task add priority:H Call my sister

姉妹に電話するタスクを完了としてマークする

task done 1

📄 ライセンス

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