Google 日历提供远程 Model Context Protocol (MCP) 服务器,让 AI 智能体能够安全地与日历数据互动。通过配置日历 MCP 服务器,您可以让 Google Antigravity 和 Claude 等 AI 应用在日历中执行操作。
日历 MCP 服务器为 AI 智能体提供了一种标准化方式,以便其:
- 读取数据:列出日历、检索活动和查看空闲时间。
- 执行操作:创建、更新和删除活动。
- 尊重安全性:继承与用户相同的权限和数据治理 控制。
前提条件
Google Cloud 项目。如需创建项目,请参阅 创建项目。
MCP 主机,例如 Google Antigravity。
如需运行此页面中的命令,请按照以下步骤在本地开发环境中设置 gcloud CLI:
- 安装 Google Cloud CLI。
如果您之前安装了 gcloud CLI,请运行
gcloud components update以确保您拥有 最新版本。 - 如果您使用的是外部身份提供方 (IdP),请使用您的联合身份登录 gcloud CLI。如需了解详情,请参阅 使用联合身份登录 gcloud CLI。
- 初始化 gcloud CLI。
- 安装 Google Cloud CLI。
如果您之前安装了 gcloud CLI,请运行
配置日历 MCP 服务器
如需使用日历 MCP 服务器,您必须在云项目中启用该服务器,然后配置 MCP 客户端以连接到该服务器。
启用 API
如需使用日历 MCP 服务器,您必须在 Cloud 项目中启用以下 API:
Google Calendar API
CLI
gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID
将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。
控制台
在控制台中启用 API:
启用 MCP 服务
如需为日历启用 MCP 组件,您必须在云项目中启用以下服务:
Calendar MCP API
CLI
gcloud services enable calendarmcp.googleapis.com --project=PROJECT_ID
将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。
控制台
在控制台中启用 MCP 服务:
设置 OAuth 权限请求页面
日历 MCP 服务器使用 OAuth 2.0 进行身份验证和授权。您必须先配置 OAuth 权限请求页面,然后才能创建 OAuth 客户端 ID。
在控制台中,依次前往 Google Auth Platform > 品牌塑造 。
如果您已配置 Google Auth Platform,则可以在 “品牌塑造”“受众群体”和“数据访问权限”中配置以下 OAuth 权限请求页面设置。 如果您看到一条消息,指出尚未配置 Google Auth Platform ,请点击开始使用:
- 在应用信息 下的应用名称 中,输入
Calendar MCP Server。 - 在用户支持邮箱 中,选择您的电子邮件地址或相应的 Google 群组。
- 点击下一步 。
- 在受众群体 下,选择内部 。如果您无法选择 内部,请选择外部。
- 点击下一步 。
- 在联系信息下,输入一个电子邮件地址,以便您 接收有关项目变更的通知。
- 点击下一步 。
- 在完成 下,查看 Google API 服务用户数据政策 ,如果您同意该政策,请选择我同意 Google API 服务:用户 数据政策。
- 点击继续 。
- 点击创建 。
- 如果您为用户类型选择了外部 ,请添加测试用户:
- 点击受众群体。
- 在测试用户 下,点击 Add users (添加用户)。
- 输入您的电子邮件地址和任何其他已获授权的测试用户,然后点击保存 。
- 在应用信息 下的应用名称 中,输入
依次点击数据访问权限 > 添加或移除范围 。系统会显示一个面板,其中列出了您在云项目中启用的每个 API 的范围。
在手动添加范围 下,粘贴 日历 MCP 服务器的范围:
https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.readonly
点击添加到表格 。
点击更新 。
选择应用所需范围后,在数据访问权限 页面上,点击保存 。
配置 MCP 客户端
如需将日历远程 MCP 服务器添加到 MCP 客户端,请按照客户端的说明操作。
Antigravity
如需将日历远程 MCP 服务器添加到 Antigravity,请将服务器配置添加到 mcp_config.json 文件。这些说明支持 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。
创建 OAuth 2.0 客户端 ID 和密钥:
在控制台中,依次前往 Google Auth Platform > 客户端 > 创建客户端
选择 Web 应用 作为应用类型。
输入名称 。
在 已获授权的重定向 URI 部分中,点击 + 添加 URI, 然后在 URI 字段中添加
https://antigravity.google/oauth-callback。点击创建 ,然后复制您的客户端 ID 和客户端密钥 。
打开或创建配置文件
~/.gemini/antigravity/mcp_config.json。将
mcpServers配置添加到mcp_config.json:{ "mcpServers": { "calendar": { "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }替换以下内容:
OAUTH_CLIENT_ID:您创建的客户端 ID。OAUTH_CLIENT_SECRET:您创建的客户端密钥。
保存
mcp_config.json。使用 GUI 设置或 CLI 对 MCP 服务器进行身份验证:
对于 Antigravity IDE 或 GUI (Antigravity 2.0):
- 打开设置界面(例如,点击左下角的设置 或打开 Antigravity 用户设置 )。
- 前往自定义 。
- 在 Installed MCP Servers (已安装的 MCP 服务器)下,点击 刷新 。
- 在列表中找到
calendar,点击 身份验证, 登录您的 Google 账号,复制授权代码, 将其粘贴到输入对话框中,然后点击 提交。
对于 Antigravity CLI:
启动 Antigravity CLI:
agy运行以下命令,打开互动式 MCP 管理面板:
/mcp使用箭头键选择
calendar,移至 Authenticate (身份验证)操作,然后按 Enter 键。在浏览器中完成登录流程,复制授权代码,将其粘贴到终端提示符中,然后按 Enter 键。
验证服务器是否已正确配置并正在运行:
- 对于 Antigravity IDE 或 GUI: 在自定义 > Installed MCP Servers (已安装的 MCP 服务器)下,服务器旁边会显示一个退出账号 按钮。
- 对于 Antigravity CLI: 打开
/mcp面板以查看您配置的 MCP 服务器。经过验证和身份验证的服务器会在互动式 TUI 面板中其名称旁边显示 Authed 。 您可以在信息中心视图下选择服务器,以检查其状态并列出其所有可用工具。
远程 MCP 服务器已准备就绪,可在 Antigravity 中使用。
Claude
如需将日历远程 MCP 服务器与 Claude.ai 或 Claude Desktop 搭配使用,您必须拥有 Claude Enterprise、Pro、Max 或 Team 方案。
如需将日历远程 MCP 服务器添加到 Claude,请使用 OAuth 客户端 ID 和密钥配置自定义连接器。
创建 OAuth 2.0 客户端 ID 和密钥:
在控制台中,依次前往 Google Auth Platform > 客户端 > 创建客户端
选择 Web 应用 作为应用类型。
输入名称 。
在已获授权的重定向 URI 部分中,点击 + 添加 URI, 然后在 URI 字段中添加
https://claude.ai/api/mcp/auth_callback。点击创建 ,然后复制您的客户端 ID 和客户端密钥 。
在 Claude 中配置 MCP 服务器:
- 在 Claude.ai 或 Claude Desktop 中,依次前往设置 (或管理员设置 )> 连接器 。
- 点击 Add custom connector (添加自定义连接器)。
- 输入日历产品的连接详细信息:
- 服务器名称:
Calendar。 - 远程 MCP 服务器网址:
https://calendarmcp.googleapis.com/mcp/v1
- 服务器名称:
- 在高级设置中,输入您的OAuth 客户端 ID和 OAuth 客户端密钥。
- 点击添加 。
其他
许多 AI 应用都有连接到远程 MCP 服务器的方式。您通常需要输入有关服务器的详细信息,例如服务器的名称、端点、传输协议和身份验证方法。对于日历远程 MCP 服务器,请输入以下内容:
服务器名称:
calendar服务器网址:
https://calendarmcp.googleapis.com/mcp/v1传输:HTTP
身份验证:日历远程 MCP 服务器 使用 OAuth 2.0。如需了解详情,请参阅 了解身份验证和授权。
如需详细了解如何连接不同类型的客户端,请参阅 在 AI 应用中配置 MCP。
测试日历 MCP 服务器
配置 MCP 客户端后,您可以运行一些测试提示来验证连接。
尝试向 MCP 客户端询问以下问题:
“我与 Ariel 的下一次会议是什么时候?”
客户端使用
calendar.list_events检查您的日程安排,并详细说明您与 Ariel 的下一次会议。
如果工具成功执行并收到相关响应,则说明您的日历 MCP 服务器已正确配置。
问题排查
如果您在连接到 MCP 服务器时遇到问题,请检查 OAuth 日志中是否存在错误。请让管理员在安全调查工具中检查OAuth 日志事件。
工具参考文档
日历 MCP 服务器可使用以下工具:
create_eventdelete_eventget_eventlist_calendarslist_eventsrespond_to_eventsuggest_timeupdate_event
安全注意事项:间接提示注入
当您将语言模型公开给不受信任的数据时,存在 间接提示注入攻击的风险。 由于 Google Antigravity 等 MCP 主机可以通过日历 MCP 服务器访问强大的工具和 API,因此它们可以读取、修改和删除您 Google 账号中的数据。
为了降低这些风险,您必须过滤提示和响应,以查找恶意内容或提示注入攻击。您可以使用 Google 提供的 Model Armor,也可以使用自己的解决方案(如果您记录了该解决方案,以便用户接受该风险)。如需了解详情,请参阅 为 Google Workspace MCP 服务器配置安全性。
请遵循以下最佳做法:
- 仅使用受信任的工具。切勿将日历 MCP 服务器连接到不受信任或未经验证的应用。
- 谨慎处理不受信任的输入。避免要求 MCP 客户端处理来自未经验证来源的活动或其他资源。这些输入可能包含隐藏的指令,这些指令可能会劫持您的会话,让攻击者能够修改、窃取或删除您的数据。
- 检查所有操作。请务必仔细检查 AI 客户端代表您执行的操作,以确保这些操作正确无误且符合您的意图。
相关主题
- 为 Google Workspace MCP 服务器配置安全性
- Antigravity 中的 Google Workspace MCP 服务器(Codelab)
- Google Workspace MCP 服务器列表