Google Calendar MCP

🚀 Google 日曆 MCP 服務器

此倉庫提供了一個與 Google Calendar API 集成的模型上下文協議（MCP）服務器。它能讓用戶對日曆事件進行列出、添加、刪除和更新等操作。該服務器專為與 Anthropic 的 Claude 桌面版搭配使用而設計，可作為 MCP 客戶端發揮作用。

🚀 快速開始

本服務器允許用戶與 Google 日曆交互，實現列出、添加、刪除和更新事件的功能，並且能夠無縫集成到 Claude 桌面版中。

✨ 主要特性

• 與 Google 日曆交互：可列出、添加、刪除和更新事件。
• 無縫集成到 Claude 桌面版。

🧰 先決條件

• 一個 Google 賬號。
• Anthropic Claude 桌面版。

📦 安裝指南

1. 安裝 UV 包管理器

按照官方 UV 安裝指南中的說明進行操作。

2. 克隆倉庫並設置環境

git clone https://github.com/rsc1102/Google_Calendar_MCP.git
cd Google_Calendar_MCP
uv sync

3. 創建 Google Cloud 憑證

• 訪問 Google Cloud 控制檯。
• 創建新項目或選擇現有項目。
• 啟用 Google Calendar API。
• 轉到 APIs & Services > 憑證。
• 點擊 Create Credentials > OAuth 客戶端 ID：
  • 選擇應用類型為 桌面應用程序。
  • 下載生成的 credentials.json 文件。
  • 將 credentials.json 放置在 Google_Calendar_MCP 目錄中。

🔌 詳細文檔

集成到 Claude 桌面版

1. 定位配置文件

打開系統中的 claude_desktop_config.json 文件：

• Linux/macOS：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Windows (PowerShell)：

code $env:AppData\Claude\claude_desktop_config.json

2. 添加 MCP 服務器配置

在 mcpServers 部分中添加以下內容：

{
    "mcpServers": {
        "calendar": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/Google_Calendar_MCP",
                "run",
                "calendar_mcp.py"
            ]
        }
    }
}

3. 重啟 Claude 桌面版

4. 創建新項目在 Claude 桌面版中

5. 設置時區

在項目的知識部分，使用 IANA 時區格式定義您的本地時區（例如 timeZone="America/New_York"）。

6. 開始聊天

開始與 Claude 互動以管理 Google 日曆事件。注意：首次使用服務器時，Google 會提示您進行身份驗證並授予訪問日曆的權限。

🎬 實際操作演示

視頻鏈接

📬 支持

如需幫助或有問題，請在此倉庫中打開問題。