G2N MCP Google Calendar SSE Server
2025.04.05
0
TypeScriptGoogle Calendar 集成日历管理日程管理
G2N MCP Google Calendar SSE Server 是一个基于 Model Context Protocol (MCP) 的服务端实现，通过 Server-Sent Events (SSE) 提供 Google Calendar 的集成功能。该服务将 Google Calendar 的功能作为工具暴露出来，供 AI 模型和应用程序（如 Cursor、Claude 和 n8n）使用，以实现与 Google Calendar 的交互。
View on GitHub
Overview
基本能力
产品定位
G2N MCP Google Calendar SSE Server 是一个专门用于集成 Google Calendar 功能的 MCP 服务器，旨在为 AI 模型和应用程序提供日历管理的工具。
核心功能
- 列出所有可用的日历
- 获取特定日历的详细信息
- 列出日历中的事件（支持过滤选项）
- 获取特定事件的详细信息
- 创建新的日历事件
- 更新现有日历事件
- 删除日历事件
- 列出事件和日历的可用颜色
适用场景
- AI 助手（如 Cursor、Claude）通过自然语言命令管理日历
- 自动化工具（如 n8n）集成日历功能到工作流中
- 开发者构建需要日历集成的应用程序
工具列表
list-calendars: 列出所有可用的日历get-calendar: 获取特定日历的详细信息list-events: 列出日历中的事件（支持过滤选项）get-event: 获取特定事件的详细信息create-event: 创建新的日历事件update-event: 更新现有日历事件delete-event: 删除日历事件list-colors: 列出事件和日历的可用颜色
常见问题解答
- 如何配置 OAuth 回调？
确保
PUBLIC_URL环境变量设置为互联网可访问的 URL，并且/oauth/callback路径正确配置。 - 如何获取 Google 刷新令牌？
确保 Traefik 配置正确指向
PORT环境变量指定的端口。 - 如何撤销访问权限？
使用
/revoke端点：curl -X POST https://your-domain.com/revoke
使用教程
使用依赖
- Docker 和 Docker Compose
- 启用了 Calendar API 的 Google Cloud 项目
- OAuth 2.0 客户端 ID 和客户端密钥
安装教程
- 设置环境变量：
env PORT=3001 PUBLIC_URL=https://your-domain.com GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID} GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} OAUTH_REDIRECT_PATH=/oauth/callback - 启动服务器：
bash docker-compose up -d
调试方式
- 检查日志：
bash docker logs -f g2n-mcp-gcal-sse - 测试连接：
bash curl http://localhost:3001/sse - 验证 OAuth 流程：
访问
/auth端点并完成授权流程。