Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Things MCP Serveradd a todo for tomorrow: call mom about birthday plans"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Things MCP Server
一个用于通过URL Scheme与Things 3任务管理应用集成的MCP（Model Context Protocol）服务器。
功能特性
✅ 创建/更新/删除待办事项和项目
✅ 导航和搜索
✅ JSON批量导入
快速开始
1. 获取授权令牌
打开Things应用：Things → Settings → General → Enable Things URLs → Manage
2. 配置Claude Code MCP
在终端运行以下命令：
# 设置环境变量
export THINGS_AUTH_TOKEN="你的授权令牌"
# 添加 MCP 服务器
claude mcp add things --command "npx" --args "-y" "@moguw/things_mcp" --env "THINGS_AUTH_TOKEN=$THINGS_AUTH_TOKEN"或者手动编辑配置文件：
macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
{
"mcpServers": {
"things": {
"command": "npx",
"args": ["-y", "@moguw/things_mcp"],
"env": {
"THINGS_AUTH_TOKEN": "你的授权令牌"
}
}
}
}3. 重启Claude Code（如果需要）
使用示例
在Claude Code中直接对话即可：
"帮我在Things中创建一个待办事项：明天给妈妈打电话"
"创建一个'学习Python'的项目"
"把ID为XXX的任务改为明天完成，并添加'紧急'标签"
"删除ID为XXX的待办事项"可用工具
工具 | 说明 | 是否需要令牌 |
| 创建待办事项 | ❌ |
| 创建项目 | ❌ |
| 更新待办事项 | ✅ |
| 更新项目 | ✅ |
| 删除待办事项 | ✅ |
| 删除项目 | ✅ |
| 导航到指定列表/项目 | ❌ |
| 搜索 | ❌ |
| JSON批量导入 | 视情况 |
| 获取版本信息 | ❌ |
详细参数说明请参考 things_url.md
系统要求
macOS (必需 - MCP服务器使用macOS专属的
open命令)Node.js >= 18.0.0
Things 3 for Mac 应用
注：虽然Things 3同时支持macOS和iOS，但此MCP服务器仅能在macOS上运行
开发
# 从源码运行
git clone https://github.com/moguw/things_mcp.git
cd things-mcp
npm install
npm run dev
# 测试
npm test许可证
MIT