金大哥 - things-mcp MCP 详情

article

README

🚀 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许可证。

🔧 贡献说明

欢迎提出问题和提交拉取请求！提交前请确保所有测试都能通过。

things-mcp