Things MCP Server 使用说明

项目简介

Things MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将您的 Things 任务管理应用连接到支持 MCP 协议的 LLM 客户端，例如 Claude Desktop。通过此服务器，您可以让 Claude 理解和操作您在 Things 应用中的数据，实现诸如创建任务、分析项目、管理优先级等功能。

主要功能点

访问 Things 列表: 支持访问 Inbox, Today, Upcoming 等主要列表。
项目和区域管理: 能够获取和操作 Things 中的项目和区域。
标签操作: 支持获取和筛选带有特定标签的任务。
高级搜索: 提供基于标题、备注、状态、日期、标签和区域的搜索功能。
最近项目跟踪: 可以获取最近创建的项目和任务。
详细信息: 返回的任务和项目信息包含清单 (checklist) 等详细内容。
嵌套数据支持: 支持处理项目在区域内，任务在项目内的嵌套关系。

安装步骤

前提条件
- Python 3.12+
- Claude Desktop 应用
- Things 3 应用 (确保在 Things 设置 -> 通用中启用 "Enable Things URLs")

安装 uv (如果尚未安装): 打开终端并运行以下命令：

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

安装完成后，重启您的终端。

克隆仓库: 使用 git 克隆 Things MCP Server 仓库到本地：

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

安装 Python 依赖: 进入克隆的 'things-mcp' 目录，创建并激活虚拟环境，然后安装依赖：

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

配置 Claude Desktop: 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'，通常位于：

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

在 'mcpServers' 键下添加 Things 服务器的配置。请将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp' 替换为您实际安装 'things-mcp' 文件夹的绝对路径：

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

配置参数说明:

'"server name": "things"': 服务器名称，在 Claude Desktop 配置中用于标识该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行 Python 脚本。
'"args": [...]': 传递给 'uv' 命令的参数列表：
- '"--directory"': 指定工作目录为 'things-mcp' 文件夹的父目录。
- '"/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp"': 请替换为 'things-mcp' 文件夹的实际绝对路径。
- '"run"': 'uv run' 命令用于运行 Python 脚本。
- '"things_server.py"': 指定要运行的服务器脚本为 'things_server.py'。

保存 'claude_desktop_config.json' 文件并重启 Claude Desktop 应用。

基本使用方法

配置完成后，您可以在 Claude Desktop 中直接与您的 Things 数据进行交互。以下是一些示例用法：

"What's on my todo list today?" (今天有什么待办事项？)
"Create a todo to pack for my beach vacation next week, include a packling checklist." (创建一个下周海滩度假的待办事项，包含一个打包清单。)
"Evaluate my current todos using the Eisenhower matrix." (使用艾森豪威尔矩阵评估我当前的待办事项。)
"Help me conduct a GTD-style weekly review using Things." (帮我使用 Things 进行 GTD 风格的每周回顾。)

使用技巧:

在 Claude 中创建一个项目，包含自定义指令，解释您如何使用 Things，如何组织区域、项目和标签等。告诉 Claude 您希望在创建新任务时包含哪些信息（例如，要求它在任务描述中包含相关详细信息可能会很有帮助）。
尝试添加另一个 MCP 服务器，让 Claude 访问您的日历。这将使您可以要求 Claude 在日历上为特定任务安排时间，从即将到来的日历事件中创建待办事项（例如，为会议做准备）等。

关键词

Things MCP Server 使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息