JinDaGe - Google_Calendar

article

README

🚀 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 会提示您进行身份验证并授予访问日历的权限。

🎬 实际操作演示

视频链接

📬 支持

如需帮助或有问题，请在此仓库中打开问题。

Google_Calendar_MCP