Google Calendar MCP Server

此仓库提供了一个与Google日历API集成的模型上下文协议（MCP）服务器。它允许用户列出、创建、删除和更新日历事件。该服务器设计用于与Anthropic的Claude桌面作为MCP客户端一起工作。

🚀 功能

• 与Google日历交互：列出、添加、删除和更新事件
• 通过MCP无缝集成到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云凭证：

   • 访问Google云控制台。
   • 创建一个新的项目或选择一个现有的项目。
   • 启用Google日历API。
   • 导航至API和服务 > 凭据。
   • 单击创建凭据 > 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会提示您进行身份验证并授予访问日历的权限。

---

🎬 实际操作

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

---

📬 支持

对于问题或疑问，请在此仓库中提交问题。