Things MCP 服务器

这个 模型上下文协议 (MCP) 服务器让你使用 Claude Desktop 与你在 Things app 中的任务管理数据进行交互。你可以让 Claude 创建任务、分析项目、帮助管理优先级等等。

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

<a href="https://glama.ai/mcp/servers/t9cgixg2ah"><img width="380" height="200" src="https://glama.ai/mcp/servers/t9cgixg2ah/badge" alt="Things Server MCP server" /></a>

功能

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

安装 (适用于 Claude Desktop)

1. 前提条件

• Python 3.12+
• Claude Desktop
• Things 3 ("启用 Things URL" 必须在 设置 -> 通用 中开启)

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 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 日志，请在终端中运行以下命令：

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