hald/things-mcp

解决的问题

如果你使用 macOS 上的 Things 3 来管理任务，通常需要在待办事项应用和 AI 助手对话之间来回切换。此服务器通过让 ChatGPT、Claude、Codex 和其他 MCP 客户端直接在对话中读取和修改你的 Things 数据，从而弥补了这一差距。你可以要求总结今天的任务、创建一个带有清单的新待办事项，或者搜索过期的项目，而无需离开聊天窗口。

工作原理

该服务器是一个本地模型上下文协议 (MCP) 服务器。它使用官方的 Things URL scheme（以及在 URL scheme 不足时使用 AppleScript）与 Things 3 进行通信。当你安装它（通过 uvx things-mcp 或一键安装包）并将其连接到 Claude Desktop 或 ChatGPT Work 等 MCP 客户端时，助手将获得一组工具的访问权限。这些工具包括读取所有标准列表（收件箱、今天、即将到来等）、创建和更新待办事项与项目、管理标签以及执行高级搜索。服务器运行在你的 Mac 上，因此它仅适用于已安装 Things 3 并开启“启用 Things URL”功能的情况。

适用人群

适用于在 macOS 上使用 Things 3 并经常与 ChatGPT、Claude 或 Codex 等 AI 助手交互的个人。它适合任何希望通过输入自然语言请求来管理个人任务，而不是每次都打开 Things 应用的用户。它不是团队协作工具，仅连接到单个用户的本地任务数据库。

主要亮点

• 访问所有主要的 Things 列表：收件箱、今天、即将到来、某天、日志、废纸篓等
• 直接在对话中创建、更新和管理待办事项、项目和区域
• 标签操作，包括用于标记未使用的标签以便清理的使用报告
• 具有状态、日期、标签、项目和创建时间过滤功能的高级搜索
• 支持嵌套数据（区域包含项目，项目包含待办事项和标题）
• “某天”项目会自动从“今天”、“即将到来”和“随时”视图中排除，符合 Things UI 的行为
• 读取工具的分页和结构化内容，支持对原始数据的程序化访问
• 批量操作：一次更新多个待办事项（重新安排、设置标签、标记完成等）
• 可选的 HTTP 传输以实现远程访问（默认为 stdio）