things-mcp

🚀 Things MCP Server

借助模型上下文协议（MCP），可直接从Claude Code、Claude Desktop、Cursor及其他AI助手控制你的Things.app任务。

🚀 快速开始

1. 获取Things授权令牌

若要更新现有任务，你需要一个授权令牌：

1. 在macOS上打开 Things.app。
2. 转到 Things → 偏好设置 → 通用。
3. 勾选 “启用Things URL”。
4. 复制显示的授权令牌。

2. 配置你的AI助手

{
  "mcpServers": {
    "things": {
      "command": "npx",
      "args": ["@wenbopan/things-mcp"],
      "env": {
        "THINGS_AUTH_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "things": {
    "command": "npx",
    "args": ["@wenbopan/things-mcp"],
    "env": {
      "THINGS_AUTH_TOKEN": "your-token-here"
    }
  }
}

3. 重启你的AI助手

配置完成后，重启你的AI助手以加载MCP服务器。

✨ 主要特性

此MCP服务器允许AI助手与你macOS上的Things.app任务进行交互。你可以：

• 创建 新任务和项目。
• 更新 现有项目。
• 查看 带有详细摘要的任务数据库。
• 安排 特定日期的任务。
• 通过区域、标签和截止日期进行 组织。

💻 使用示例

日常规划

"显示我今天的任务，并为新的营销活动创建一个项目，包含研究、设计和内容创作的初始任务。"

项目管理

"更新移动应用项目，添加设计评审和测试任务，然后将设计评审安排到下周一。"

任务组织

"将我所有未安排的购物任务移到“个人”区域，并标记为“周末”。"

进度跟踪

"给我所有活跃项目的摘要，包括截止日期和完成状态。"

快速记录

"创建一个给牙医打电话的任务，安排在明天，并设定本周末为截止日期。"

📄 许可证

本项目采用MIT许可证。

🔧 贡献说明

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