Google Calendar MCP 服务器

此仓库提供了一个与 Google Calendar API 集成的模型上下文协议 (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。
   • 导航到 API 和服务 > 凭据。
   • 点击 创建凭据 > OAuth 客户端 ID：
     • 选择 桌面应用 作为应用程序类型。
     • 下载生成的 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。