TaskWarrior MCP 服务器

Node.js 服务器实现用于 TaskWarrior 操作的 Model Context Protocol (MCP)。

功能

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

注意：这会运行你本地的 task 命令行工具，因此需要安装并配置好 TaskWarrior！

[!WARNING]
当前使用的是任务 id，这是一个不稳定的标识符；当添加或删除新任务时，taskwarrior 有时会重新编号任务。未来应该更加谨慎地使用任务 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 文件。