← 返回目录

Google Calendar MCP Server

社区

为AI助手提供Google Calendar集成

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 35 / 55
Stars: ★ 1.2k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 8 天前
工具数: 12

50FMRS · D

该服务器为Google Calendar提供了全面的MCP集成，功能丰富，包括多账户支持和智能调度。它需要适当的OAuth设置，并可能需要进行一些初始配置。总体而言，对于希望直接通过AI助手管理日历的用户来说，这是一个不错的工具。

最强项 · 文档质量 16/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

7/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 5/20: 证据：README声称支持多账户、12个工具、认证流程及-32600错误行为。扣分：未提供源代码、测试或CI；无法验证服务器启动、MCP握手或工具是否与真实行为一致。缺少执行证据限制得分。
安全与权限 8/20: 证据：README披露OAuth令牌存储在系统配置目录，可选范围，工具过滤以实现最小权限，并声称凭证不会离开本地机器。扣分：未通过源代码验证令牌处理或数据流；破坏性delete-event缺乏明确确认；未详述每次操作的同意机制。
维护活跃度 7/20: 证据：仓库未归档，MIT许可证，4个开放问题。扣分：未提供提交/发布历史、依赖更新证据或安全响应渠道。无法确认活跃度；星数不计分。
文档质量 16/20: 证据：README提供详细安装（npx/本地/Docker）、Claude配置示例、环境变量、工具过滤、认证/重新认证步骤、故障排除以及架构/测试文档链接。扣分：对限制（速率限制、错误码）披露较少，无成本/使用说明，但总体很强。
安装易用性 14/20: 证据：清晰的多种安装路径（npx/本地/Docker），包含先决条件、配置片段和认证说明。扣分：没有CI或已提交的测试来验证这些步骤能产生可用连接；仍存在手动注意事项（测试用户传播、浏览器问题）；因缺少执行证据而设上限。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要集成Google Calendar的AI助手用户
希望管理多个Google账户的用户
需要高级事件管理功能（如重复事件和空闲/忙碌查询）的用户

不适合谁

没有Google Cloud项目的用户
希望快速设置而不进行OAuth配置的用户
需要与Google Calendar以外其他日历系统集成的用户

所需权限

读取和修改Google日历事件
跨账户访问日历
创建、更新、删除和搜索事件
响应邀请
检查空闲/忙碌信息

风险与副作用

OAuth令牌可能泄露或过期
测试模式下令牌每7天过期，需要重新认证
用户需注意Google Cloud配额和限制
若配置不当，凭据可能暴露在日志中

安装接入

准备工作

运行环境：Node.js · Docker

GOOGLE_OAUTH_CREDENTIALS 必填密钥指向从 Google Cloud Console 下载的 OAuth 凭据文件（gcp-oauth.keys.，Desktop 应用类型）的绝对路径。

其他可选配置项（2 个）

GOOGLE_CALENDAR_MCP_TOKEN_PATH 可选可选，自定义 OAuth 令牌的存储位置；不设置时使用系统配置目录。

ENABLED_TOOLS 可选可选，逗号分隔的工具名列表，用于限制暴露给 AI 的工具以节省上下文或增强安全性。

在Google Cloud Console中创建一个项目，并启用Google Calendar API。
创建OAuth 2.0凭据，选择“桌面应用”类型，并下载JSON文件。
在Claude Desktop配置中添加服务器，使用npx命令并提供凭据路径。
启动Claude Desktop，询问AI助手认证Google Calendar MCP服务器。
在浏览器中完成OAuth流程。

claude_desktop_config.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add google-calendar -e GOOGLE_OAUTH_CREDENTIALS=/path/to/your/gcp-oauth.keys.json -- npx @cocal/google-calendar-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动客户端后，先要求 AI "Authenticate with Google Calendar" 完成 OAuth 流程，然后在工具列表中应能看到 list-calendars、list-events、create-event 等工具；让 AI 调用 list-calendars 返回你的日历列表即证明连接成功。

常见排障

确保GOOGLE_OAUTH_CREDENTIALS环境变量指向有效的凭据文件
验证凭据类型为“桌面应用”，用户邮箱已添加为测试用户
重新认证：运行npm run auth或npx @cocal/google-calendar-mcp auth
检查端口3500-3505是否被占用，可能阻碍认证
确保凭据文件包含project_id字段，以避免速率限制错误

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查看我本周个人和工作日历上都有哪些日程，哪些不是我的日常例行安排？
帮我在日历上创建一个明天下午2点的会议日程。
查看明天哪些活动有受邀者尚未接受邀请？
接受我日历上明天下午2点的团队会议邀请。

工具能力 12

list-calendars 只读

列出所有可用日历

list-events 只读

使用日期筛选列出事件

get-event 只读

按ID获取特定事件的详细信息

search-events 只读

通过文本查询搜索事件

create-event 写入

创建新的日历事件

update-event 写入

更新现有事件

delete-event 破坏性

删除事件

respond-to-event 写入

回复事件邀请（接受、拒绝、可能、不回复）

展开其余 4 个工具

get-freebusy 只读

检查跨日历（包括外部日历）的可用性

get-current-time 只读

获取日历时区的当前日期和时间

list-colors 只读

列出可用的事件颜色

manage-accounts 写入

添加、列出或移除已连接的Google账户

使用场景

跨个人和工作日历查找可用时间段

从屏幕截图或图片添加事件

分析日历中的非常规事件

检查活动出席情况并回复邀请

根据提供的时间段自动协调活动

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

该服务器实现了用于Google Calendar的模型上下文协议（MCP）集成，支持多账户、多日历和高级事件管理。它允许AI助手执行创建、更新、删除和搜索事件等操作，还能处理重复事件、检查空闲/忙碌状态，并利用自然语言理解日期和时间。该服务器支持从图片、PDF和网页链接智能导入事件，并能跨不同日历检测冲突。它需要Google Cloud项目并进行OAuth设置。