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的待办事项"

可用工具

工具	说明	是否需要令牌
add_todo	创建待办事项	❌
add_project	创建项目	❌
update_todo	更新待办事项	✅
update_project	更新项目	✅
delete_todo	删除待办事项	✅
delete_project	删除项目	✅
show	导航到指定列表/项目	❌
search	搜索	❌
json_import	JSON批量导入	视情况
get_version	获取版本信息	❌

详细参数说明请参考 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