Calendar MCP Server

🚀 Google Calendar MCP 服務器

Google Calendar MCP 服務器是一個用於 Google 日曆集成的 Claude 桌面 Model Context Protocol (MCP) 服務器。藉助該服務器，AI 助手能夠通過自然語言交互來管理 Google 日曆事件。

🚀 快速開始

本服務器可助力 AI 助手通過自然語言交互管理 Google 日曆事件，下面為你介紹其功能、安裝、配置及使用方法。

✨ 主要特性

• 創建帶有標題、時間、描述和位置的日曆事件
• 通過事件 ID 查取詳細信息
• 更新現有事件（標題、時間、描述、位置）
• 刪除事件
• 在指定時間段內列出事件
• 完全集成 Google 日曆 API
• 安全的 OAuth2 認證

📦 安裝指南

使用 Smithery 自動安裝

通過 Smithery 可自動安裝 Google 日曆對 Claude 桌面的集成：

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手動安裝

npm install @gongrzhe/server-calendar-mcp

📚 詳細文檔

配置

1. 創建 Google Cloud 項目並獲取憑證： a. 創建 Google Cloud 項目：
   • 訪問 Google Cloud Console
   • 創建新項目或選擇現有項目
   • 啟用項目的 Google 日曆 API b. 創建 OAuth 2.0 憑證：
   • 轉到 "APIs & Services" > "Credentials"
   • 點擊 "Create Credentials" > "OAuth client ID"
   • 選擇應用類型為 "Desktop app"
   • 輸入名稱並點擊 "Create"
   • 獲取客戶端 ID 和密鑰 c. 使用 OAuth2 獲取訪問令牌：
   • 訪問 Google API Console
   • 創建項目並啟用日曆 API
   • 添加 OAuth 客戶端 ID
   • 生成 OAuth 2.0 令牌
2. 在 Claude 桌面配置中添加以下內容：

{
  "calendar": {
    "enable": true,
    "apiKey": "你的 Google 日曆 API 密鑰",
    "clientId": "你的客戶端 ID",
    "clientSecret": "你的客戶端密鑰"
  }
}

💻 使用示例

基礎用法

創建日曆事件

{
  "summary": "會議提醒",
  "start.dateTime": "2024-03-15T10:00:00+08:00",
  "end.dateTime": "2024-03-15T11:00:00+08:00"
}

獲取事件列表

{
  "timeMin": "2024-03-15T00:00:00+08:00",
  "maxResults": 10
}

⚠️ 重要提示

⚠️ 重要提示

• 安裝完成後重啟 Claude 桌面以應用配置
• 確保 API 密鑰和客戶端憑證安全，避免洩露
• 定期更新訪問令牌以增強安全性

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。

📄 許可證

本項目 licensed under ISC License。

👨‍💻 作者

gongrzhe