🚀 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 会提示您进行身份验证并授予访问日历的权限。
🎬 实际操作演示
📬 支持
如需帮助或有问题，请在此仓库中打开问题。