Gtasks MCP

🚀 谷歌任務 MCP 服務器

本 MCP 服務器與 Google Tasks 集成，可實現對任務的列出、讀取、搜索、創建、更新和刪除操作，為用戶提供便捷的任務管理體驗。

🚀 快速開始

前期準備

1. 創建新的 Google Cloud 項目
2. 啟用 Google Tasks API
3. 配置 OAuth 同意屏幕（測試時“內部”即可）
4. 添加範圍 https://www.googleapis.com/auth/tasks
5. 創建桌面應用類型的 OAuth 客戶端 ID
6. 下載客戶端的 OAuth 密鑰 JSON 文件
7. 將密鑰文件重命名為 gcp-oauth.keys.json 並放置在此存儲庫的根目錄中（即 gcp-oauth.keys.json）

構建項目

確保使用 npm run build 或 npm run watch 進行構建。

通過 Smithery 安裝

要通過 Smithery 自動安裝 Google Tasks Server，可執行以下命令：

npx -y @smithery/cli install @zcaceres/gtasks --desktop

使用說明

• 將服務器二進制文件命名為 gtasks-mcp 並放置在默認的可執行路徑中
• 從命令行運行 gtasks-mcp
• 訪問 http://localhost:8080 使用 Web 界面

✨ 主要特性

工具

• search

  • 功能：在 Google Tasks 中搜索任務
  • 輸入：query（字符串）：搜索查詢
  • 輸出：返回匹配的任務及其詳細信息

• list

  • 功能：列出 Google Tasks 中的所有任務
  • 可選輸入：cursor（字符串）：分頁遊標
  • 輸出：返回所有任務的列表

• create

  • 功能：在 Google Tasks 中創建新任務
  • 輸入：
    • taskListId（字符串，可選）：任務列表 ID
    • title（字符串，必需）：任務標題
    • notes（字符串，可選）：任務備註
    • due（字符串，可選）：截止日期
  • 輸出：返回任務創建確認

• update

  • 功能：更新 Google Tasks 中的現有任務
  • 輸入：
    • taskListId（字符串，可選）：任務列表 ID
    • id（字符串，必需）：任務 ID
    • uri（字符串，必需）：任務 URI
    • title（字符串，可選）：新任務標題
    • notes（字符串，可選）：新任務備註
    • status（字符串，可選）：新任務狀態（"needsAction" 或 "completed"）
    • due（字符串，可選）：新截止日期
  • 輸出：返回任務更新確認

• delete

  • 功能：刪除 Google Tasks 中的任務
  • 輸入：
    • taskListId（字符串，必需）：任務列表 ID
    • id（字符串，必需）：任務 ID
  • 輸出：返回任務刪除確認

• clear

  • 功能：從 Google Tasks 任務列表中清除已完成的任務
  • 輸入：taskListId（字符串，必需）：任務列表 ID
  • 輸出：返回已清除任務的確認

資源

服務器提供對 Google Tasks 資源的訪問：

• Tasks (gtasks:///<task_id>)
  • 表示 Google Tasks 中的單個任務
  • 支持讀取任務詳細信息，包括標題、狀態、截止日期、備註和其他元數據
  • 可通過提供的工具進行列出、讀取、創建、更新和刪除

💻 使用示例

基礎用法

# 創建任務
curl -X POST http://localhost:8080/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"完成項目","notes":"需要在週五前完成"}'

# 列出所有任務
curl http://localhost:8080/api/tasks

# 更新任務狀態
curl -X PUT http://localhost:8080/api/tasks/123 \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

🔧 依賴項

• Node.js 和 npm 已安裝

建議的命令行工具

• jq ：用於處理 JSON 數據
• curl ：用於發送 HTTP 請求

⚠️ 重要提示

• 確保你的 Google Cloud 項目已啟用 billing
• 安裝依賴時使用 npm install
• 使用前請閱讀完整的文檔和示例