Things MCP 服务器

这个 Model Context Protocol (MCP) 服务器允许你使用 Claude Desktop 与 Things 应用中的任务管理数据进行交互。你可以让 Claude 帮助你创建任务、分析项目、管理优先级等。

该服务器利用了 Things.py 库和 Things URL Scheme。

功能

• 访问所有主要的 Things 列表（收件箱、今天、即将到来等）
• 项目和区域管理
• 标签操作
• 高级搜索功能
• 最近项目跟踪
• 包括检查清单在内的详细项目信息
• 支持嵌套数据（区域内的项目，项目内的待办事项）

安装（适用于 Claude Desktop）

1. 先决条件

• Python 3.12+
• Claude Desktop
• Things 3（必须在设置 -> 通用中启用 "Enable Things URLs"）

1. 如果尚未安装，请安装 uv：

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

之后重启你的终端。

1. 克隆此仓库：

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

1. 安装所需的 Python 包：

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

1. 编辑 Claude Desktop 配置文件：

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

将 Things 服务器添加到配置文件的 mcpServers 键中（确保更新到你安装这些文件的文件夹路径）：

{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }
    }
}

重启 Claude Desktop 应用程序。

Claude Desktop 示例用法

• "我今天的待办事项是什么？"
• "为下周的海滩度假创建一个打包待办事项，并包含一个打包清单。"
• "使用艾森豪威尔矩阵评估我当前的待办事项。"
• "使用 Things 帮我进行 GTD 风格的每周回顾。"

小贴士

• 在 Claude 中创建一个带有自定义说明的项目，解释你如何使用 Things 并组织区域、项目、标签等。告诉 Claude 在创建新任务时你想包括哪些信息（例如，要求它在任务描述中包括相关细节可能会有所帮助）。
• 尝试添加另一个 MCP 服务器，使 Claude 能够访问你的日历。这将允许你要求 Claude 为你特定的任务在日历上安排时间，从即将到来的日历事件创建待办事项（例如会议准备）等。

可用工具

列表视图

• get-inbox - 获取收件箱中的待办事项
• get-today - 获取今日到期的待办事项
• get-upcoming - 获取即将到来的待办事项
• get-anytime - 获取任意时间列表中的待办事项
• get-someday - 获取某天列表中的待办事项
• get-logbook - 获取已完成的待办事项
• get-trash - 获取已删除的待办事项

基本操作

• get-todos - 获取待办事项，可按项目过滤
• get-projects - 获取所有项目
• get-areas - 获取所有区域

标签操作

• get-tags - 获取所有标签
• get-tagged-items - 获取具有特定标签的项目

搜索操作

• search-todos - 通过标题/备注简单搜索
• search-advanced - 使用多个过滤器的高级搜索

基于时间的操作

• get-recent - 获取最近创建的项目

工具参数

get-todos

• project_uuid (可选) - 按项目过滤待办事项
• include_items (可选，默认: true) - 包含检查项

get-projects / get-areas / get-tags

• include_items (可选，默认: false) - 包含包含的项目

search-advanced

• status - 按状态过滤（未完成/已完成/已取消）
• start_date - 按开始日期过滤（YYYY-MM-DD）
• deadline - 按截止日期过滤（YYYY-MM-DD）
• tag - 按标签过滤
• area - 按区域 UUID 过滤
• type - 按项目类型过滤（待办事项/项目/标题）

get-recent

• period - 时间段（例如，'3d', '1w', '2m', '1y'）

故障排除

服务器包括以下错误处理：

• 无效的 UUID
• 缺少必需的参数
• Things 数据库访问错误
• 数据格式错误

所有错误都会被记录并返回描述性消息。要从 Claude Desktop 查看 MCP 日志，请在终端中运行以下命令：

# Follow logs in real-time
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log