MCP Googletasks

🚀 Google 任務 MCP 服務器

此模型上下文協議 (MCP) 服務器充當 Claude 和 Google Tasks 之間的橋樑，允許您直接通過 Claude 管理您的任務列表和任務，極大提升任務管理的便捷性。

⚠️ 重要提示

此項目中所有代碼（除了一些修改）都是由 Claude 根據我的指令 "vibe 編碼" 生成的。

✨ 主要特性

此 MCP 服務器提供以下功能：

任務列表管理

• list-tasklists - 列出所有任務列表
• get-tasklist - 獲取特定任務列表的詳細信息
• create-tasklist - 創建新的任務列表
• update-tasklist - 更新現有任務列表
• delete-tasklist - 刪除任務列表

任務管理

• list-tasks - 列出任務列表中的所有任務
• get-task - 獲取特定任務的詳細信息
• create-task - 創建新任務
• update-task - 更新現有任務
• delete-task - 刪除任務
• complete-task - 標記任務為已完成
• move-task - 移動任務（重新排序或更改父項）
• clear-completed-tasks - 從列表中清除所有已完成的任務

📦 安裝指南

1. 創建 Google Cloud 項目並啟用 API

1. 訪問 Google Cloud Console
2. 創建新項目
3. 轉到 "APIs & Services" > "Library"
4. 搜索 "Google Tasks API" 並啟用它
5. 轉到 "APIs & Services" > "Credentials"
6. 點擊 "Create Credentials" > "OAuth Client ID"
7. 配置 OAuth 一致界面屏幕（對於個人使用，External 是可以的）
8. 對於應用程序類型，選擇 "Web 應用程序"
9. 將 "http://localhost:3000" 添加為授權重定向 URI
10. 創建客戶端 ID 和秘密

2. 配置 Claude for Desktop

1. 安裝 Claude for Desktop
2. 打開 Claude 配置文件：
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 添加 Google Tasks MCP 服務器配置：

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}

替換為您的路徑和憑證。

3. 構建並運行服務器

1. 安裝依賴項：

npm install

2. 構建服務器：

npm run build

3. 重啟 Claude for Desktop

🚀 快速開始

首次使用 Google Tasks MCP 服務器時：

1. 使用 authenticate 工具獲取授權 URL
2. 在瀏覽器中訪問該 URL 並使用您的 Google 賬戶登錄
3. 授權後，您將在瀏覽器頁面上收到代碼
4. 使用 set-auth-code 工具和此代碼完成認證
5. 現在您可以使用所有其他工具與 Google Tasks 交互

⚠️ 重要提示

您的認證是會話式的，並會在服務器重啟時丟失。每次需要重新啟動服務器時都需要重新認證。

📚 詳細文檔

要求

• Node.js 14+
• 最新版本的 Claude for Desktop
• 已啟用 Google Cloud 項目中的 Tasks API

截圖

📄 許可證

此項目僅用於演示用途。自行承擔風險使用。