TaskWarrior MCP Server

TaskWarrior MCP Server

site icon
2025.03.16 9
JavaScript任务管理个人效率工具开发效率
TaskWarrior MCP Server 是一个基于Node.js的服务,实现了Model Context Protocol (MCP),用于与TaskWarrior任务管理工具进行交互。它提供了查看、过滤、添加和标记完成任务的功能,帮助用户更高效地管理个人任务。
View on GitHub

Overview

基本能力

产品定位

TaskWarrior MCP Server 是一个任务管理服务,通过MCP协议与TaskWarrior工具集成,提供任务管理的自动化能力。

核心功能

  • 查看待处理任务
  • 按项目和标签过滤任务
  • 添加新任务(包括描述、截止日期、优先级、项目和标签)
  • 标记任务为完成

适用场景

  • 个人任务管理
  • 工作项目管理
  • 优先级任务跟踪

工具列表

  • get_next_tasks:获取所有待处理任务列表,支持按项目和标签过滤。
  • add_task:添加新任务,支持设置描述、截止日期、优先级、项目和标签。
  • mark_task_done:标记任务为完成,需要提供任务ID或UUID。

常见问题解答

  • 注意:该服务使用本地task二进制文件,因此需要预先安装和配置TaskWarrior。
  • 当前使用任务id作为标识符,这可能不稳定,未来将改用任务UUID。

使用教程

使用依赖

确保已安装并配置好TaskWarrior (task)工具。

安装教程

npm install -g mcp-server-taskwarrior

调试方式

在Claude Desktop中使用时,需在claude_desktop_config.json中添加配置:

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

示例用法

  • 查看当前工作任务:task project:work next
  • 添加高优先级任务:task add priority:H Call my sister
  • 标记任务为完成:task done 1

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。