Things Safe MCP

一个面向 Things 3 的非官方 MCP 服务器，仅使用 Cultured Code 文档中列为安全的集成方式：

• AppleScript 用于读取和普通任务编辑。

• Things URL scheme 用于清单编辑。

它从不读取或写入 Things 数据库、应用支持文件或 Things Cloud 凭证。仅支持 macOS，且需要 Things 3。

安装

先安装 uv，然后将服务器注册到你的 MCP 客户端。对于 Codex：

codex mcp add things -- uvx --from git+https://github.com/jasongibby/things-safe-mcp things-safe-mcp

对于其他 stdio MCP 客户端，使用：

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jasongibby/things-safe-mcp",
        "things-safe-mcp"
      ]
    }
  }
}

在首次请求前，先启动一次 Things。macOS 会请求授权你的 MCP 主机自动化 Things。

清单令牌

只有清单编辑需要 Things URL 授权令牌。在 Things 中，打开 设置 → 通用 → 启用 Things URLs → 管理，生成一个令牌，并通过 MCP 客户端的安全环境配置将其作为 THINGS_AUTH_TOKEN 提供给服务器。不要提交或泄露它。

所有其他操作均无需令牌即可使用。

工具

• 读取收件箱、今天、即将到来、随时、某天、项目、项目任务以及直接打标签的任务。

• 搜索任务标题和备注。

• 创建任务。

• 编辑标题、备注、标签、状态、日程和项目分配。传入空的项目 ID 可分离任务。

• 替换、追加或清单项。

安全与隐私

Cultured Code 将 AppleScript 和 Things URL scheme 列为安全连接方式。该服务器将用户输入作为进程参数传递，而不是将其插入 AppleScript 源码。

你的 MCP 客户端和 AI 提供商会看到服务器返回的任务数据。使用前请查看其隐私政策。本项目与 Cultured Code 无关联，也未获得其认可。

• Third-Party AI Tools and Things

• Things AppleScript Commands

• Things URL Scheme

开发

uv sync
uv run python -m unittest discover -s tests -v

测试会模拟所有外部进程，绝不会访问 Things。

License

MIT