google-calendar-mcp-serviceaccount

一个最小化的 MCP 服务器，为 AI 代理提供一个 Google Calendar 的读/写访问权限，通过服务账号进行身份验证，而非交互式 OAuth。

为什么使用服务账号

大多数 Google Calendar MCP 服务器使用 OAuth：应用要求人类登录并授予同意，就像真实的多用户产品那样。对于仅需要访问你自己的日历的个人助手，这比实际所需的步骤更多——发布到生产环境、验证域名、定期重新同意。

服务账号则省去这一切：你可以像与另一个人共享一样，将日历共享给服务账号的邮箱。凭据在你撤销之前不会过期。

权衡： 它仅适用于你可以通过电子邮件明确共享的日历（个人 Google 账户、大多数 Workspace 配置）——它无法像完整的 OAuth 授权那样在整个用户账户上广泛操作。

费用： 截至撰写本文时，以下设置中所有内容都是免费的——无需将结算账户或信用卡附加到 Google Cloud 项目。Calendar API 的免费额度远超个人助手的使用量。这未来可能变化；如有疑问，请查看当前的 Google Cloud 定价。

Related MCP server: Google Calendar MCP Server

工具

没有 delete_event 是有意为之——如果你希望代理能删除日历条目，请自行添加。

设置

想借助 AI 编码助手进行设置？让它参考 AGENTS.md——那里有人类和代理双方的完整分步说明。

手动操作：

1. 在 Google Cloud Console 中：创建项目，启用 Calendar API，创建服务账号（不是 OAuth 客户端），下载其 JSON 密钥

2. 用“对事件进行更改”的权限，将你的 Google Calendar 共享给服务账号的电子邮件地址。记下日历的 ID：对于你的主日历，这通常就是你的电子邮件地址；对于任何其他日历，可以在该日历的“设置” → “整合日历” → “日历 ID”中找到

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. 将 .env.example 复制为 .env，填写密钥路径和你的日历 ID

5. 将 calendar_server.py 以 stdio 服务器的方式注册到你的 MCP 客户端，并传入这两个变量作为其环境

许可证

MIT — 见 LICENSE。