Things MCP Server

# 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 在终端运行以下命令： ```bash # 设置环境变量 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` ```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的待办事项" ``` ## 可用工具 | 工具 | 说明 | 是否需要令牌 | |------|------|--------------| | `add_todo` | 创建待办事项 | ❌ | | `add_project` | 创建项目 | ❌ | | `update_todo` | 更新待办事项 | ✅ | | `update_project` | 更新项目 | ✅ | | `delete_todo` | 删除待办事项 | ✅ | | `delete_project` | 删除项目 | ✅ | | `show` | 导航到指定列表/项目 | ❌ | | `search` | 搜索 | ❌ | | `json_import` | JSON批量导入 | 视情况 | | `get_version` | 获取版本信息 | ❌ | 详细参数说明请参考 [things_url.md](./things_url.md) ## 系统要求 - **macOS** (必需 - MCP服务器使用macOS专属的`open`命令) - **Node.js** >= 18.0.0 - **Things 3 for Mac** 应用 > 注：虽然Things 3同时支持macOS和iOS，但此MCP服务器仅能在macOS上运行 ## 开发 ```bash # 从源码运行 git clone https://github.com/moguw/things_mcp.git cd things-mcp npm install npm run dev # 测试 npm test ``` ## 许可证 MIT