Things App

🚀 事项 MCP 服务器

这个 模型上下文协议 (MCP) 服务器可让你借助 Claude 桌面版，与 Things 应用 中的任务管理数据进行交互。你能让 Claude 创建任务、分析项目、协助管理优先级等。

该服务器借助了 Things.py 库和 Things URL 方案。

🚀 快速开始

此服务器能让你使用 Claude 桌面版与 Things 应用中的任务管理数据交互，实现创建任务、分析项目等功能。

✨ 主要特性

• 可访问所有主要的 Things 列表（收件箱、今天、即将进行等）
• 支持项目和领域管理
• 能进行标签操作
• 具备高级搜索功能
• 可跟踪最近项目
• 提供详细的任务信息，包括检查列表
• 支持嵌套数据（领域中的项目、项目中的待办事项）

📦 安装指南

适用于 Claude 桌面版

1. 先决条件
   • Python 3.12+
   • Claude 桌面版
   • Things 3 （“启用 Things URLs” 必须在设置 -> 通用中打开）
2. 若尚未安装，安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

重新启动终端。 3. 克隆此仓库：

git clone https://github.com/hald/things-mcp

4. 安装所需的 Python 包：

cd things-mcp
uv venv
uv pip install -r pyproject.toml

5. 编辑 Claude 桌面版配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 JSON 数组中添加以下内容：

{
  "mcpEndpoints": [
    {
      "name": "Things",
      "url": "http://localhost:9001"
    }
  ]
}

💻 使用示例

基础用法

提供一些在 Claude 桌面版中使用该服务器的示例问题：

• 列出所有项目和待办事项。
• 创建新的任务或项目。
• 根据截止日期筛选任务。
• 更新现有任务的状态或属性。

小贴士

⚠️ 重要提示

该服务器包括对以下错误的处理：无效的 UUID、缺少必填参数、Things 数据库访问错误、数据格式错误。所有错误都会记录并带有描述性消息返回。

💡 使用建议

• 在设置中启用 Things 数据库的日志记录，以便更好地调试和监控：

defaults write com.culturedcode.Things-MacOS developer-mode -bool true

• 使用 poetry run 命令运行服务器以隔离依赖项环境。

📚 详细文档

可用工具

查询工具

• /items
  获取 Things 数据库中的所有项目和待办事项。支持分页加载更多数据。

创建工具

• /items/create
  在 Things 中创建新的任务或项目。

更新工具

• /items/update
  更新现有任务或项目的属性和状态。

工具参数

查询工具 (/items)

创建工具 (/items/create)

更新工具 (/items/update)

故障排除

要查看 Claude 桌面版的 MCP 日志，请在终端中运行：

# 实时跟踪最后 20 行日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log