🚀 Things MCP Server
本项目允许你通过模型上下文协议（MCP），直接在Claude Code、Claude Desktop、Cursor等AI助手内控制Things.app中的任务，为任务管理带来极大便利。
🚀 快速开始
1. 获取Things授权令牌
若要更新现有任务，你需要一个授权令牌，获取步骤如下：
- 在macOS上打开 Things.app。
- 点击 Things → 偏好设置 → 常规。
- 勾选 “启用Things URL”。
- 复制显示的授权令牌。
2. 配置你的AI助手
Claude Desktop
在macOS系统中，将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中：
{
"mcpServers": {
"things": {
"command": "npx",
"args": ["@wenbopan/things-mcp"],
"env": {
"THINGS_AUTH_TOKEN": "your-token-here"
}
}
}
}
Cursor IDE
在你的项目中创建 .cursor/mcp.json 文件，或者在全局路径 ~/.cursor/mcp.json 下创建该文件，内容如下：
{
"things": {
"command": "npx",
"args": ["@wenbopan/things-mcp"],
"env": {
"THINGS_AUTH_TOKEN": "your-token-here"
}
}
}
3. 重启你的AI助手
配置完成后，重启AI助手以加载MCP服务器。
✨ 主要特性
此MCP服务器允许AI助手与你macOS上的Things.app任务进行交互，你可以：
- 创建 新的任务和项目。
- 更新 现有任务项。
- 查看 详细的任务数据库摘要。
- 安排 任务到特定日期。
- 通过区域、标签和截止日期 组织 任务。
💻 使用示例
日常规划
“显示我今天的任务，并为新的营销活动创建一个项目，包含研究、设计和内容创作的初始任务。”
项目管理
“更新移动应用项目，添加设计评审和测试任务，然后将设计评审安排到下周一。”
任务组织
“将我所有未安排的购物任务移动到‘个人’区域，并标记为‘周末’。”
进度跟踪
“给我所有活跃项目的摘要，包括截止日期和完成状态。”
快速记录
“创建一个给牙医打电话的任务，安排在明天，并设置截止日期为本周末。”
📄 许可证
本项目采用MIT许可证。
🔧 贡献说明
欢迎提出问题和提交拉取请求！提交前请确保所有测试都能通过。