适合谁
- 需要集成Google Calendar的AI助手用户
- 希望管理多个Google账户的用户
- 需要高级事件管理功能（如重复事件和空闲/忙碌查询）的用户
G
50FMRS · D
该服务器为Google Calendar提供了全面的MCP集成，功能丰富，包括多账户支持和智能调度。它需要适当的OAuth设置，并可能需要进行一些初始配置。总体而言，对于希望直接通过AI助手管理日历的用户来说，这是一个不错的工具。
该服务器实现了用于Google Calendar的模型上下文协议（MCP）集成，支持多账户、多日历和高级事件管理。它允许AI助手执行创建、更新、删除和搜索事件等操作，还能处理重复事件、检查空闲/忙碌状态，并利用自然语言理解日期和时间。该服务器支持从图片、PDF和网页链接智能导入事件，并能跨不同日历检测冲突。它需要Google Cloud项目并进行OAuth设置。
工具能力
list-calendars
列出所有可用日历
list-events
使用日期筛选列出事件
get-event
按ID获取特定事件的详细信息
search-events
通过文本查询搜索事件
create-event
创建新的日历事件
update-event
更新现有事件
delete-event
删除事件
respond-to-event
回复事件邀请（接受、拒绝、可能、不回复）
get-freebusy
检查跨日历（包括外部日历）的可用性
get-current-time
获取日历时区的当前日期和时间
list-colors
列出可用的事件颜色
manage-accounts
添加、列出或移除已连接的Google账户
安装接入
- 在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"
}
}
}
}
选型与风险
不适合谁
- 没有Google Cloud项目的用户
- 希望快速设置而不进行OAuth配置的用户
- 需要与Google Calendar以外其他日历系统集成的用户
所需权限
- 读取和修改Google日历事件
- 跨账户访问日历
- 创建、更新、删除和搜索事件
- 响应邀请
- 检查空闲/忙碌信息
风险与副作用
- OAuth令牌可能泄露或过期
- 测试模式下令牌每7天过期，需要重新认证
- 用户需注意Google Cloud配额和限制
- 若配置不当，凭据可能暴露在日志中
常见排障
- 确保GOOGLE_OAUTH_CREDENTIALS环境变量指向有效的凭据文件
- 验证凭据类型为“桌面应用”，用户邮箱已添加为测试用户
- 重新认证：运行npm run auth或npx @cocal/google-calendar-mcp auth
- 检查端口3500-3505是否被占用，可能阻碍认证
- 确保凭据文件包含project_id字段，以避免速率限制错误
使用场景
跨个人和工作日历查找可用时间段
从屏幕截图或图片添加事件
分析日历中的非常规事件
检查活动出席情况并回复邀请
根据提供的时间段自动协调活动
支持客户端
Claude Desktop完整支持