Google Calendar MCP Server

Google Calendar MCP 服务

这是一个 Model Context Protocol（MCP）服务，可集成 Google Calendar。 它允许 LLM 应用通过标准化接口管理日历事件。

功能

• 列出可用日历
• 列出日历中的事件
• 创建日历事件
• 更新现有事件
• 删除事件

Google Cloud 设置

1. 前往 Google Cloud 控制台
2. 创建新项目或选择现有项目。
3. 启用 Google Calendar API。
4. 创建 OAuth 2.0 凭据：
   • 前往 凭据
   • 点击 “创建凭据” > “OAuth 客户端 ID”
   • 选择 “用户数据” 作为应用将访问的数据类型。
   • 添加应用名称和联系信息。
   • 添加以下范围（可选）：
     • https://www.googleapis.com/auth/calendar.events
   • 选择 “桌面应用” 作为应用类型。
   • 在 OAuth 同意屏幕中将你的电子邮件地址添加为测试用户。
     • 注意： 测试用户信息可能需要几分钟才能生效。

安装

步骤

1. 克隆仓库：

   git clone <repository-url>
   cd gcal-mcp-server
   

2. 创建虚拟环境：

   uv venv
   # On Mac / linux
   source .venv/bin/activate
   # On Windows
   .venv\Scripts\activate
   # Install package in editable mode
   uv pip install -e .
   

用法

1. 设置 .env 文件，填入 LLM 所需的环境变量。
2. 运行服务：

   uv run client.py