gcal-mcp-server

🚀 Google Calendar MCP 服务器

这是一个基于Model Context Protocol (MCP) 的服务器，借助标准化接口实现与Google Calendar的集成。它为LLM应用程序提供了管理日历事件的能力，方便用户进行各类日历操作。

🚀 快速开始

在使用本服务器前，你需要完成Google Cloud的相关设置，并进行服务器的安装。具体步骤如下：

✨ 主要特性

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

📦 安装指南

步骤

1. 克隆仓库：

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

2. 创建虚拟环境：

uv venv
# 在 Mac/Linux 上
source .venv/bin/activate
# 在 Windows 上
.venv\Scripts\activate
# 以编辑模式安装包
uv pip install -e .

📚 详细文档

Google Cloud 设置

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

💻 使用示例

基础用法

运行服务器

# 设置所需的 `.env` 文件环境变量。
# 运行服务器
uv run client.py