Things MCP Server

基本能力

产品定位

Things MCP Server 是一个任务管理服务，旨在通过 Claude Desktop 提供高级的任务管理功能，帮助用户更高效地管理日常任务和项目。

核心功能

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

适用场景

• 日常任务管理
• 项目规划和跟踪
• 优先级管理
• 任务搜索和分析

工具列表及能力

列表视图

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

基本操作

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

标签操作

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

搜索操作

• search-todos - 按标题/笔记简单搜索
• search-advanced - 带有多重过滤器的高级搜索

基于时间的操作

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

常见问题解答

• 错误处理包括无效的 UUID、缺少必需参数、Things 数据库访问错误和数据格式化错误。
• 所有错误都会被记录并返回描述性消息。

使用教程

使用依赖

1. Python 3.12+
2. Claude Desktop
3. Things 3（必须在设置 -> 通用中启用“启用 Things URL”）

安装教程

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 应用。

调试方式

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。