Google Calendar MCP Server

基本能力

产品定位

Google Calendar MCP Server 是一个用于与 Google Calendar 交互的 MCP 服务器，主要用于查询和管理日历事件。

核心功能

• 通过 Google Calendar API 搜索日历内容。
• 支持多日历管理（如主日历和工作日历）。
• 通过 MCP 服务器与 GitHub Copilot Chat 集成，实现自然语言查询日历事件。

适用场景

• 个人日程管理：查询特定日期的日历事件。
• 团队协作：管理多个日历（如工作日历和团队日历）。
• 自动化工具集成：与其他工具（如 GitHub Copilot Chat）集成，实现自动化查询。

工具列表

• uv: 用于创建虚拟环境和下载依赖库。
• generate_token.py: 用于生成 token.json 文件，授权访问 Google 账户。
• calendar_settings.json: 配置日历 ID。
• mcp.json: 配置 MCP 服务器参数。

常见问题解答

• 错误处理: 如果出现错误，检查错误消息并重新安装依赖或检查 Google Cloud Console 中的设置。

使用教程

使用依赖

1. 安装 uv。
2. 拥有 Google 账户。

安装教程

1. 创建 Google Cloud 项目: 启用 Google Calendar API。 sh [Enable API](https://console.cloud.google.com/flows/enableapi?apiid=calendar-json.googleapis.com&hl=en)
2. 设置 OAuth 2.0 同意屏幕: 在 Google Cloud Console 中配置应用名称和支持邮箱。 sh [Branding](https://console.cloud.google.com/auth/branding?hl=en)
3. 设置桌面应用凭据: 创建凭据并下载 credentials.json。 sh [Client](https://console.cloud.google.com/auth/clients?hl=en)
4. 设置 Python 环境: sh uv sync
5. 生成 token.json: sh uv run generate_token.py
6. 配置 calendar_settings.json: 编辑并重命名 calendar_settings.json.sample。
7. 配置 MCP: 编辑并重命名 mcp.json.sample。
8. 配置 Agent 模式: 在 VS Code 中启用 GitHub Copilot Chat 的 Agent 模式。

调试方式

1. 打开 Copilot Chat 面板。
2. 输入查询（如 "List the events for April 8th."）。
3. 确认工具执行并授权访问 Google 账户。
4. 查看结果。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。