Google Calendar MCP Server Xke

🚀 谷歌日曆 MCP 服務器

此 MCP 服務器可與 Google 日曆集成，藉助統一接口，讓 Claude 能夠查看、創建和管理日曆事件。

🚀 快速開始

本 MCP 服務器可實現與 Google 日曆的集成，使 Claude 能通過統一接口對日曆事件進行查看、創建和管理等操作。

✨ 主要特性

• 列出可用的日曆
• 從一個日曆中列出事件
• 創建新的日曆事件
• 更新現有事件
• 刪除事件

📦 安裝指南

先決條件

• Node.js 16 或更高版本
• 啟用 Google Cloud 項目中的 Calendar API
• OAuth 2.0 憑證（客戶端 ID 和客戶端密鑰）

Google Cloud 設置

1. 訪問 Google Cloud Console
2. 創建新項目或選擇現有項目
3. 啟用 Google 日曆 API
4. 創建 OAuth 2.0 憑證：
   • 轉到 憑證
   • 點擊 “創建憑證” > “OAuth 客戶端 ID”
   • 選擇 “桌面應用” 作為應用類型
   • 給它一個名稱（例如，“Google 日曆 MCP”）
   • 下載憑證 JSON 文件
   • 將下載的文件重命名為 gcp-oauth.keys.json 並放在該項目根目錄中

安裝步驟

1. 安裝依賴項：

   npm install
   

2. 構建 TypeScript 代碼：

   npm run build
   

3. 更新 Claude MCP 設置文件以包含此服務器：
   • 將以下內容添加到 cline_mcp_settings.json：

   "github.com/pashpashpash/google-calendar-mcp": {
     "command": "node",
     "args": ["C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"],
     "env": {},
     "disabled": false,
     "autoApprove": []
   }
   

🔧 技術細節

認證流程

首次使用 Google 日曆 MCP 服務器時，它會：

1. 檢測到您沒有認證令牌
2. 啟動一個認證服務器（在端口 3000 - 3004 上）
3. 打開瀏覽器窗口進行 OAuth 認證
4. 安全保存認證令牌
5. 關閉認證服務器並繼續正常運行

您的認證令牌將存儲在 .gcp-saved-tokens.json 中，並會自動刷新。

💻 使用示例

基礎用法

列出日曆

list-calendars

列出事件

list-events
calendarId: "primary"
timeMin: "2023-01-01T00:00:00Z"
timeMax: "2023-12-31T23:59:59Z"
maxResults: 10

創建事件

create-event
calendarId: "primary"
summary: "團隊會議"
location: "會議室 B"
description: "每週一次的團隊同步會議"
startDateTime: "2023-06-15T10:00:00"
endDateTime: "2023-06-15T11:00:00"

更新事件

update-event
eventID: "eventId123"
calendarId: "primary"
summary: "更新的團隊會議"
description: "更新後的會議描述"

刪除事件

delete-event
eventID: "eventId123"
calendarId: "primary"

📚 詳細文檔

可用工具

⚠️ 故障排除

• 如果無法連接到 Google 日曆，檢查網絡連接和 API 權限。
• 確保 gcp-oauth.keys.json 文件存在且配置正確。