Gongrzhe Calendar MCP Server

🚀 Google Calendar MCP 服務器

Google Calendar MCP 服務器是一個用於 Google 日曆集成的 Claude Desktop 模型上下文協議（MCP）服務器。藉助該服務器，AI 助手能夠通過自然語言交互來管理 Google 日曆事件，為用戶提供便捷的日曆管理體驗。

🚀 快速開始

本服務器允許 AI 助手通過自然語言交互管理 Google 日曆事件，你可以按照以下步驟進行安裝和設置。

✨ 主要特性

• 創建日曆事件：可創建帶有標題、時間、描述和位置的日曆事件。
• 檢索事件信息：通過事件 ID 檢索事件詳細信息。
• 更新事件內容：能夠更新現有事件的標題、時間、描述和位置。
• 刪除事件操作：支持刪除指定事件。
• 列出指定時段事件：可在指定時間段內列出事件。
• 集成 Google 日曆 API：與 Google 日曆 API 完全集成。
• 安全認證機制：採用安全的 OAuth2 身份驗證。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Claude Desktop 的 Google 日曆集成，可使用以下命令：

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

手動安裝

使用以下命令進行手動安裝：

npm install @gongrzhe/server-calendar-mcp

📚 詳細文檔

設置步驟

1. 創建 Google Cloud 項目並獲取憑證：
   • 創建 Google Cloud 項目：
     • 訪問 Google Cloud Console。
     • 創建新項目或選擇現有項目。
     • 啟用項目的 Google 日曆 API。
   • 創建 OAuth 2.0 憑證：
     • 轉到“APIs & Services” > “Credentials”。
     • 點擊“創建憑據” > “OAuth 客戶端 ID”。
     • 選擇“桌面應用”作為應用程序類型。
     • 輸入名稱並點擊“創建”。
     • 獲取您的 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET。
   • 獲取刷新令牌：
     • 訪問 OAuth 2.0 Playground。
     • 點擊右上角的齒輪圖標（設置）。
     • 啟用“使用自己的 OAuth 憑證”。
     • 輸入您的 OAuth 客戶端 ID 和客戶端密鑰。
     • 在左側面板中找到“Calendar API v3”並選擇 "https://www.googleapis.com/auth/calendar"。
     • 點擊“授權 API”並完成 OAuth 流程。
     • 點擊“交換授權代碼以獲取令牌”。
     • 複製“刷新令牌”，這就是您的 GOOGLE_REFRESH_TOKEN。
2. 在 Claude Desktop 中配置：

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

💻 使用示例

基礎用法

創建日曆事件

# 創建新日曆
curl -X POST http://localhost:3000/calendars \
  -H 'Content-Type: application/json' \
  -d '{"name": "My Calendar"}'

# 在指定日曆中創建事件
curl -X POST http://localhost:3000/calendars/[CALENDAR_ID]/events \
  -H 'Content-Type: application/json' \
  -d '{"summary": "Meeting", "start": {"dateTime": "2024-01-01T10:00:00"}, "end": {"dateTime": "2024-01-01T11:00:00"}}'

獲取事件

# 獲取所有日曆
curl http://localhost:3000/calendars

# 獲取特定日曆的事件
curl http://localhost:3000/calendars/[CALENDAR_ID]/events

⚠️ 重要提示

• 刷新令牌提供對您的 Google 日曆的訪問權限，請妥善保管。
• 不要將憑證提交到版本控制系統。
• 定期更新和管理 API 密鑰以確保安全。

💡 使用建議

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

📄 許可證

本項目使用 ISC 許可證。

👨‍💻 作者

gongrzhe