Things MCP 服务器在 Claude 和 Windsurf 上的增强型 FastMCP 实现
概览
这个模型上下文协议（MCP）服务器允许你使用 Claude Desktop 与 Things 应用中的任务管理数据交互。你可以让 Claude 创建任务、分析项目、帮助管理优先级等。 该服务器利用 Things.py 库和Things URL方案，并具备以下额外的可靠性功能： - 采用指数退回和重试机制 - 防止连锁失败 - 针对失败操作 - 提升性能 - 结构化 JSON 输出 - 针对 URL 方案失败的操作 - 防止 Things 应用过载 - 提高可靠性 这个MCP服务器解锁了AI在任务管理中的强大功能： - ： 让Claude用自然语言创建包含所有细节的任务 - ： 获取对项目和生产力模式的洞察 - ： 让Claude帮你实现生产力系统 - ： 直接处理你现有的Things 3数据 - 访问所有主要的事项列表（收件箱、今日、即将发布的事项等）。
概述（AI 翻译）
这个模型上下文协议（MCP）服务器允许你使用 Claude Desktop 与 Things 应用中的任务管理数据交互。你可以让 Claude 创建任务、分析项目、帮助管理优先级等。
该服务器利用 Things.py 库和Things URL方案，并具备以下额外的可靠性功能：
- 强健的错误处理，具指数退回和重试机制
- 断路器模式以防止连锁故障
- 失败操作的死符队列
- 智能缓存以提升性能
- 结构化JSON输出的全面日志
- AppleScript 桥接，用于 URL 方案失败的操作
- 速率限制以防止Things应用过载
- 广泛的测试套件以保证可靠性
为什么是MCP？
这个MCP服务器解锁了AI在任务管理中的强大功能：
- 自然语言任务创建：请Claude用自然语言创建包含所有细节的任务
- 智能任务分析：深入了解您的项目和生产力模式
- GTD 与生产力工作流程：让 Claude 帮助您实施生产力系统
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Things MCP Server
This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. You can ask Claude to create tasks, analyze projects, help manage priorities, and more.
This server leverages the Things.py library and the Things URL Scheme, with additional reliability features including:
- Robust error handling with exponential backoff and retry mechanisms
- Circuit breaker pattern to prevent cascading failures
- Dead letter queue for failed operations
- Intelligent caching for improved performance
- Comprehensive logging with structured JSON output
- AppleScript bridge for operations that fail with URL schemes
- Rate limiting to prevent overwhelming the Things app
- Extensive test suite for reliability
Why Things MCP?
This MCP server unlocks the power of AI for your task management:
- Natural Language Task Creation: Ask Claude to create tasks with all details in natural language
- Smart Task Analysis: Get insights into your projects and productivity patterns
- GTD & Productivity Workflows: Let Claude help you implement productivity systems
- Seamless Integration: Works directly with your existing Things 3 data
Features
- Access to all major Things lists (Inbox, Today, Upcoming, etc.)
- Project and area management
- Tag operations
- Advanced search capabilities
- Recent items tracking
- Detailed item information including checklists
- Support for nested data (projects within areas, todos within projects)
Installation Options
There are multiple ways to install and use the Things MCP server:
Option 1: Install from PyPI (Recommended)
Prerequisites
- Python 3.12+
- Claude Desktop
- Things 3 (“Enable Things URLs” must be turned on in Settings -> General)
- Things Authentication Token (required for URL scheme operations)
Installation
pip install things-mcp
Or using uv (recommended):
uv pip install things-mcp
Running
After installation, you can run the server directly:
things-mcp
Option 2: Manual Installation
Prerequisites
- Python 3.12+
- Claude Desktop
- Things 3 (“Enable Things URLs” must be turned on in Settings -> General)
Step 1: Install uv
Install uv if you haven’t already:
curl -LsSf https://astral.sh/uv/install.sh | sh
Restart your terminal afterwards.
Step 2: Clone this repository
git clone https://github.com/hald/things-mcp
cd things-mcp
Step 3: Set up Python environment and dependencies
uv venv
uv pip install -r pyproject.toml
Step 4: Configure Things authentication token
Run the configuration tool to set up your Things authentication token:
python configure_token.py
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"things": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
"run",
"things_server.py"
]
}
}
}