Google Calendar MCP Server
2025.04.03
1
TypeScript日历管理日程自动化日程管理
Google Calendar MCP Server 是一个基于 Model Context Protocol (MCP) 的实现，专门用于与 Google Calendar 进行交互。它支持通过命令行接口 (CLI) 或服务器发送事件 (SSE) 来管理日历事件。该服务提供了创建、读取、更新和删除日历事件的功能，以及查找可用时间的功能。
View on GitHub
Overview
基本能力
产品定位
Google Calendar MCP Server 是一个专门用于与 Google Calendar 交互的服务，通过 MCP 协议提供日历事件的管理功能。
核心功能
- 列出日历事件
- 创建新事件
- 更新现有事件
- 删除事件
- 查找可用时间
适用场景
- 个人日程管理
- 团队会议安排
- 自动化日程管理
- 与其他 MCP 客户端集成
工具列表
- list_events: 列出指定时间范围内的事件
- create_event: 创建新事件
- update_event: 更新现有事件
- delete_event: 删除事件
- find_free_time: 查找可用时间
常见问题解答
- 认证问题: 检查凭证是否正确，刷新令牌是否有效
- 服务器启动失败: 检查环境变量是否设置，构建是否成功
- SSE连接失败: 检查端口是否可用，端点配置是否正确
使用教程
使用依赖
- Node.js 18 或更高版本
- Google 账户并启用 Google Calendar API
- Google Cloud Console 的 OAuth 2.0 凭证
安装教程
- 复制环境文件:
cp .env.example .env
- 配置 OAuth 2.0 凭证:
GOOGLE_CLIENT_ID=seu-client-id
GOOGLE_CLIENT_SECRET=seu-client-secret
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback
GOOGLE_REFRESH_TOKEN=seu-refresh-token
PORT=3334
- 安装依赖:
npm install
- 构建代码:
npm run build
调试方式
- 启动 HTTP/SSE 服务器:
npm run start:http
- 启动 CLI 模式:
npm run start:stdio
- 开发模式:
npm run dev