Google Calendar MCP 让 AI 助手直接读取、创建和更新你的日历事件,用自然语言管日程。

日程散在多个日历里时,找一段两人都有空的时间要翻半天。Google Calendar MCP 服务器把日历能力开放给 AI 客户端:列事件、建会议、改时间、查忙闲,全部用一句话完成,还能跨多个日历做联合排期。它基于 Google OAuth 2.0,需要你先准备好凭据文件。

核心能力

  1. 多日历列事件:同时列出个人与工作日历的即将到来的事件。场景:「这周我有什么非常规日程?」
  2. 创建与更新事件:指定标题、时间、地点、参会人建会议,也能改已有事件。场景:「明天下午 2 点约 John 开会」「把 2 点会议挪到 3 点」。
  3. 忙闲查询与智能排期:跨日历查可用时段。场景:「看我的个人和工作日历,找下周和伦敦同事 1 小时的空档」。
  4. 从图片/链接建事件:把截图、PDF 或网页里的活动信息加进日历。场景:上传一张活动海报截图,「按图里信息建一个日历事件」。

使用上手

  1. 建 Google Cloud 项目并启用 Calendar API(console.cloud.google.com)。
  2. 配置 OAuth:同意屏选 External、加自己为测试用户,凭据类型选「Desktop app」,下载 JSON 存为 gcp-oauth.keys.json。
  3. 接入客户端:在 claude_desktop_config.json 加入:
{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/绝对路径/gcp-oauth.keys.json"
      }
    }
  }
}
  1. 首次启动客户端会弹 OAuth 流程,浏览器授权后即可用。
  2. 测试:「列出我明天的所有事件」。

优点与不足

  • 优点:自然语言排期,支持多日历与图片建事件;官方 npm 包开箱即用。
  • 不足:需配置 Google Cloud 与 OAuth,测试模式令牌约一周过期需重跑授权;不同发行版配置略有差异。

适合谁

  • 日历排得满、常跨多个日历协调的人;助理型工作流开发者;希望把日程交给 AI 打理的用户。

下载与访问

能力对照表:

能力说明
列出事件多日历同时读取
创建/更新标题、时间、地点、参会人
忙闲查询跨日历找空档
图片建事件从截图/PDF/链接提取

本文属于「连接器」分类的 AI 资源专栏,更多评测见分类页。