用途:在 Obsidian 的 TaskNotes 库中创建、读取、更新、完成和筛选任务,涵盖前置数据(frontmatter)、任务正文与清单,以及重复任务实例、时间追踪和番茄钟等操作。
主要能力:创建任务、更新字段(含状态、优先级、projects、details)、按 AND/OR 条件查询与分页列出、切换状态、读取可用状态/优先级/项目/上下文、完成重复任务单个实例或物化某日实例。环境探测:先尝试 MCP 工具(tool_search("tasknotes"));再请求 http://127.0.0.1:8080/api/health(返回 401 表示服务在运行但缺 token);最后检查是否具备读写 .md 文件的能力,据此路由到 MCP、HTTP API 或文件系统路径。
关键约定:projects 必须是 wikilink 数组,如 ["[[Domain - Home]]"];tags 必须包含 task;状态流转为 open → in-progress → done;日期统一用 YYYY-MM-DD;MCP 查询参数为扁平结构(conjunction、children、sortKey 等),conditions 用 property 而非 field;get/update 用 id(库内相对路径)。HTTP API 基址为 http://127.0.0.1:{port}/api,需 Authorization: Bearer <token>,用 127.0.0.1 而非 localhost。
限制:重复任务不可直接标记 done,否则关闭整个系列;HTTP API 与 MCP 均不支持 schema 诊断,需切到文件系统路径;文件系统路径下 Obsidian 关闭时无副作用;配置发现若作用域为盘符根或用户主目录须先询问用户;未提供具体工具名称与完整安装命令细节。MCP 客户端需自行配置 Bearer token(插件 v4.13.0+),该配置属于用户侧。