TaskPaper文件管理服务

一个无需AppleScript即可直接读写TaskPaper纯文本文件的服务,支持多种任务管理操作。

  • by brokosz
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 brokosz/taskpaper-mcp

使用说明

任务文件mcp

MCP读写服务器 任务文件 纯文本文件。不需要AppleScript,直接与 .taskpaper 文件格式。

安装

npm install -g taskpaper-mcp

或者在不安装的情况下使用:

npx taskpaper-mcp

配置

集 TASKPAPER_DIR 到包含您的 .taskpaper 文件夹。如果未设置,则默认为 $HOME.

Kiro CLI/克劳德桌面/任何MCP客户端

{
  "mcpServers": {
    "taskpaper": {
      "command": "npx",
      "args": ["taskpaper-mcp"],
      "env": {
        "TASKPAPER_DIR": "/path/to/your/taskpaper/files"
      }
    }
  }
}

工具

工具 说明
list_files 列出全部 .taskpaper 配置目录中的文件
list_projects 列出所有具有任务/完成计数的项目
list_tasks 列出任务,按项目、标记或完成状态筛选
list_tags 列出所有具有不同值计数和值的唯一标签
search 按文本、标签或类型搜索项目
read_file 完整解析的轮廓为结构化JSON
add_task 添加任务(可选地在项目下,带有标签和注释)
add_tasks 在一次操作中批量添加多个任务
add_project 添加新项目
add_projects 批量添加多个项目
add_note 在项目或任务下添加注释
add_tag 为匹配的项目添加任何标签
add_tags 批量为多个项目添加标签
remove_tag 从匹配的项目中删除标签
modify_tag 更改匹配项目的标签值
complete_task 切换 @done 关于任务匹配
archive_done 全部移动 @done 要存档的项目
move_task 将任务移动到其他项目

任务纸张格式

纯文本。每一行都是一个项目:

  • 项目:以结尾的行 : (例如。 Groceries:)
  • 任务:以开头的行 - (例如。 - Buy milk)
  • 备注:还有别的吗
  • 标签: @name 或 @name(value) 线上的任何地方
  • 层级:选项卡缩进

支持所有标签。常见惯例: @done, @due(date), @priority(n), @today, @flagged.

许可证

麻省理工学院