gtasks-mcp - Google Tasks 模型上下文協定伺服器

項目概述

gtasks-mcp 是一個專為 Claude AI 設計的 Google Tasks 模型上下文協定（MCP）伺服器。該項目允許 Claude 直接與 Google Tasks API 整合，實現對 Google 任務的完整管理功能。

項目地址： https://github.com/zcaceres/gtasks-mcp

主要功能

核心工具（Tools）

1. search - 搜尋任務

功能描述： 在 Google Tasks 中搜尋任務
輸入參數：
- query (string): 搜尋查詢字串
返回結果： 匹配的任務詳細資訊

2. list - 列出任務

功能描述： 列出 Google Tasks 中的所有任務
輸入參數：
- cursor (string, 可選): 分頁游標
返回結果： 所有任務的列表

3. create - 建立任務

功能描述： 在 Google Tasks 中建立新任務
輸入參數：
- taskListId (string, 可選): 任務列表 ID
- title (string, 必需): 任務標題
- notes (string, 可選): 任務備註
- due (string, 可選): 截止日期
返回結果： 任務建立確認資訊

4. update - 更新任務

功能描述： 更新現有的 Google Tasks 任務
輸入參數：
- taskListId (string, 可選): 任務列表 ID
- id (string, 必需): 任務 ID
- uri (string, 必需): 任務 URI
- title (string, 可選): 新任務標題
- notes (string, 可選): 新任務備註
- status (string, 可選): 新任務狀態（"needsAction" 或 "completed"）
- due (string, 可選): 新截止日期
返回結果： 任務更新確認資訊

5. delete - 刪除任務

功能描述： 刪除 Google Tasks 中的任務
輸入參數：
- taskListId (string, 必需): 任務列表 ID
- id (string, 必需): 任務 ID
返回結果： 任務刪除確認資訊

6. clear - 清除已完成任務

功能描述： 清除 Google Tasks 任務列表中的已完成任務
輸入參數：
- taskListId (string, 必需): 任務列表 ID
返回結果： 清除操作確認資訊

資源（Resources）

伺服器提供對 Google Tasks 資源的存取：

任務資源 (gtasks:///<task_id>)
- 表示 Google Tasks 中的單個任務
- 支援讀取任務詳細資訊，包括標題、狀態、截止日期、備註和其他元數據
- 可以使用提供的工具進行列出、讀取、建立、更新和刪除操作

安裝和配置

前置要求

建立 Google Cloud 項目
- 訪問 Google Cloud Console 建立新項目
啟用 Google Tasks API
- 在 Google Cloud Console 中啟用 API
配置 OAuth 同意畫面
- 在 OAuth 同意畫面進行配置
- 測試環境選擇 "internal" 即可
- 添加作用域：https://www.googleapis.com/auth/tasks
建立 OAuth 客戶端 ID
- 在憑證頁面建立
- 應用程式類型選擇 "桌面應用"
- 下載 OAuth 密鑰的 JSON 檔案
- 將密鑰檔案重新命名為 gcp-oauth.keys.json 並放置在項目根目錄

建構項目

使用以下命令建構伺服器：

npm run build

或使用監聽模式：

npm run watch

自動安裝（推薦）

通過 Smithery 自動安裝：

npx -y @smithery/cli install @zcaceres/gtasks --client claude

身份驗證

運行伺服器並進行身份驗證：

npm run start auth

這將在系統瀏覽器中打開身份驗證流程
完成身份驗證過程
憑證將保存在項目根目錄（.gdrive-server-credentials.json）

Claude Desktop 整合

要將此伺服器與 Claude Desktop 應用程式整合，請在應用程式的伺服器配置中添加以下內容：

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

技術特點

完整的 CRUD 操作：支援任務的建立、讀取、更新、刪除
高級搜尋功能：可以根據關鍵詞搜尋任務
任務狀態管理：支援標記任務為完成或待處理
分頁支援：處理大量任務時提供分頁功能
OAuth 2.0 認證：安全的 Google API 訪問
TypeScript 支援：提供類型安全和更好的開發體驗

使用場景

個人任務管理：通過 Claude 自然語言交互管理日常待辦事項
項目協作：在團隊項目中通過 AI 助手管理任務分配
自動化工作流：結合其他工具實現任務管理自動化
生產力提升：通過語音或文本快速建立和更新任務

注意事項

需要有效的 Google 帳戶和 Google Tasks 訪問權限
首次使用需要完成 OAuth 認證流程
建議在生產環境中妥善保管認證憑證檔案
遵循 Google API 使用配額和限制