TaskWarrior MCP Server

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

<a href="https://glama.ai/mcp/servers/e8w3e1su1x"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1341274577,2082148642&fm=3081&app=3081&f=PNG?w=760&h=400" alt="TaskWarrior Server MCP server" /> </a>

功能

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

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

[!警告] 目前使用的是任务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
• 待办事项：给姐姐打电话（高优先级）
  • 执行：task add priority:H Call my sister
• 好的，我已经给姐姐打过电话了
  • 执行：task done 1

许可证

此MCP服务器采用MIT许可证。详情见LICENSE文件。