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許可證。

🔧 貢獻說明

歡迎提出問題和提交拉取請求！提交前請確保所有測試都能通過。