TaskWarrior MCP Server

TaskWarrior MCP 服务

基于 Node.js 实现的 MCP 服务，用于执行 TaskWarrior 操作。

功能

• 查看待处理任务
• 按项目和标签筛选任务
• 添加包含描述、截止日期、优先级、项目和标签的新任务
• 将任务标记为已完成

注意：此服务会运行本地的 task 二进制文件，因此需要安装并配置 TaskWarrior！

警告

此服务目前使用 task id，这是一个不稳定的标识符；添加或删除任务时，TaskWarrior 有时会重新分配任务编号。未来应改用 task UUID，以更谨慎地处理此问题。

API

工具

• get_next_tasks

  • 获取所有待处理任务的列表
  • 可选筛选条件：
    • project：按项目名称筛选
    • tags：按一个或多个标签筛选

• 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 文件。