Google Calendar MCP Server

Google Calendar MCP 服务

此代码库提供了一个可与 Google Calendar API 集成的 Model Context Protocol（MCP）服务。用户可以列出、创建、删除和更新日历事件。此服务旨在与 Anthropic 的 Claude Desktop 作为 MCP 客户端配合使用。

🚀 功能

• 与 Google Calendar 交互：列出、添加、删除和更新事件
• 通过 MCP 与 Claude Desktop 无缝集成

---

🧰 先决条件

• Google 账号
• Anthropic Claude Desktop

---

📦 安装

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 Console。
   • 创建新项目或选择现有项目。
   • 启用 Google Calendar API。
   • 前往 APIs & Services > Credentials。
   • 点击 Create Credentials > OAuth Client ID：
     • 将应用类型选为 Desktop app。
     • 下载生成的 credentials.json 文件。
     • 将 credentials.json 放入 Google_Calendar_MCP 目录中。

---

🔌 与 Claude Desktop 集成

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 Desktop。

4. 在 Claude Desktop 中创建新项目。

5. 设置时区： 在项目的知识部分，使用 IANA 时区格式定义本地时区（例如，timeZone="America/New_York"）。

6. 开始聊天： 开始与 Claude 互动，以管理 Google Calendar 事件。
   **注意：**首次使用此服务时，Google 会提示你进行身份验证，并授予访问日历的权限。

---

🎬 实际效果

https://github.com/user-attachments/assets/75da4943-15c4-4ec2-bc5d-af4af3509031

---

📬 支持

如有问题或疑问，请在此代码库中提交 issue。