Google Calendar Oic

🚀 Google Calendar MCP 服務器工具說明文檔

本工具為 Google Calendar 打造了 MCP（機器對機器協議）接口，藉助該接口，您能夠輕鬆執行創建、更新、刪除事件以及獲取日曆列表等操作，還能在不重啟 Claude 的情況下切換 Google 賬戶，極大提升了使用的便捷性。

🚀 快速開始

MCP 消息格式

MCP 通信採用 JSON - RPC 協議，具體請求格式如下：

{
  "jsonrpc": "2.0",
  "method": "tool.name",
  "params": {
    "calendarId": "primary", // 日曆 ID，默認為 "primary"
    "event": { ... }, // 具體事件信息
    ...
  },
  "id": 1
}

✨ 主要特性

• 創建事件：使用 createEvent 工具在日曆中添加新的日程安排。
• 更新事件：利用 updateEvent 工具修改現有事件的詳細信息。
• 刪除事件：通過 deleteEvent 工具移除特定的日程安排。
• 獲取日曆列表：使用 getCalendars 工具檢索所有可訪問的日曆。
• 認證工具：新增 authenticate 工具，支持在不重啟 Claude 的情況下切換不同的 Google 賬戶。

📦 安裝指南

文檔未提及安裝步驟，暫不提供。

💻 使用示例

基礎用法

createEvent

{
  "jsonrpc": "2.0",
  "method": "createEvent",
  "params": {
    "calendarId": "primary",
    "event": {
      "summary": "會議",
      "description": "討論項目進度",
      "start": {
        "dateTime": "2024-01-01T10:00:00"
      },
      "end": {
        "dateTime": "2024-01-01T11:00:00"
      }
    }
  },
  "id": 1
}

updateEvent

{
  "jsonrpc": "2.0",
  "method": "updateEvent",
  "params": {
    "eventId": "123456",
    "calendarId": "primary",
    "event": {
      "summary": "重要會議"
    }
  },
  "id": 2
}

deleteEvent

{
  "jsonrpc": "2.0",
  "method": "deleteEvent",
  "params": {
    "eventId": "123456",
    "calendarId": "primary"
  },
  "id": 3
}

getCalendars

{
  "jsonrpc": "2.0",
  "method": "getCalendars",
  "params": {},
  "id": 4
}

高級用法

createEvent 重複事件創建

{
  "jsonrpc": "2.0",
  "method": "createEvent",
  "params": {
    "calendarId": "primary",
    "event": {
      "summary": "週會",
      "description": "每週項目總結",
      "start": {
        "dateTime": "2024-01-01T10:00:00"
      },
      "end": {
        "dateTime": "2024-01-01T11:00:00"
      },
      "recurrence": [
        "RRULE:FREQ=WEEKLY"
      ]
    }
  },
  "id": 5
}

📚 詳細文檔

工具說明

createEvent

• 功能：創建新的日程安排。
• 參數：
  • calendarId（可選）：指定目標日曆，默認為 "primary"。
  • event：包含事件詳細信息的對象，必須包括 summary, description, start, 和 end 字段。

updateEvent

• 功能：更新現有事件的信息。
• 參數：
  • eventId：需要修改的事件 ID。
  • calendarId（可選）：目標日曆，默認為 "primary"。
  • event：包含要更新字段的對象，未提供的字段將保持原值。

deleteEvent

• 功能：刪除指定的日程安排。
• 參數：
  • eventId：要刪除的事件 ID。
  • calendarId（可選）：目標日曆，默認為 "primary"。

getCalendars

• 功能：獲取所有可訪問的日曆列表。
• 返回值：包含日曆 ID 和名稱的對象數組。

🔧 技術細節

版本歷史記錄

版本 1.0.6 更新內容

• 刪除了不必要的授權範圍 (scope) 設置，優化了與 Google Calendar API 的集成。

版本 1.0.5 更新內容

• 新增功能：
  • 支持通過 recurrence 參數在 createEvent 和 updateEvent 中直接創建和修改重複事件。
  • 允許用戶無需手動設置即可管理重複日程安排。

版本 1.0.4 更新內容

• 維護版本更新，與最新依賴保持兼容性。
• 沒有功能性變化，主要優化內部代碼結構。

版本 1.0.3 更新內容

• 新增功能：

  • 引入 authenticate 工具，支持在運行時重新認證。
  • 實現了賬戶切換功能，無需重啟 Claude 即可更改 Google 賬戶。
  • 提供手動認證選項，適用於無法訪問 localhost 的環境。
  • 增加控制檯界面，便於用戶輸入授權碼。

• 優化改進：

  • 更新 zod 依賴至最新版本（3.24.2）。
  • 修復了多個潛在的安全性和性能問題。

版本 1.0.2 更新內容

• 修復了一個可能導致日曆訪問權限錯誤的 bug。

🤝 貢獻指南

• 代碼倉庫：項目託管在GitHub。
• 提交問題：使用Github Issues報告問題或提出建議。
• 參與開發：歡迎 Fork 倉庫並 Pull Request。

🧪 測試指南

• 測試要求：

  • 確保擁有有效的 Google Calendar 賬戶。
  • 配置正確的 API 密鑰和授權權限。

• 測試方法：

npm test

📄 許可證

本項目遵循MIT License協議，源代碼可在Github獲取。

如有任何問題，請聯繫支持團隊或訪問我們的官方文檔。