Google Calendar MCP Server
2025.03.05
0
TypeScript日历服务日程管理日程管理
Google Calendar MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，提供与 Google Calendar 的集成功能。它允许通过标准化接口让 LLMs（大型语言模型）读取、创建和管理日历事件。该服务支持列出可用日历、列出日历事件、创建新事件、更新现有事件、删除事件以及从截图和图像中处理事件等功能。
View on GitHub
Overview
基本能力
产品定位
Google Calendar MCP Server 是一个用于与 Google Calendar 集成的服务，旨在通过标准化接口让 LLMs 能够管理和操作日历事件。
核心功能
- 列出可用日历
- 列出日历中的事件
- 创建新日历事件
- 更新现有事件
- 删除事件
- 从截图和图像中处理事件
适用场景
- 个人日程管理
- 团队协作中的日程安排
- 从图像或截图中自动添加事件
- 检查活动出席情况
- 自动协调会议时间
工具列表
list-calendars: 列出所有可用日历list-events: 列出日历中的事件create-event: 创建新日历事件update-event: 更新现有日历事件delete-event: 删除日历事件
常见问题解答
- OAuth Token 一周后过期：测试模式下的应用需要每周重新进行 OAuth 流程。
- OAuth Token 错误：检查
gcp-oauth.keys.json格式是否正确，或删除.gcp-saved-tokens.json并重新认证。 - TypeScript 构建错误：确保所有依赖已安装，Node.js 版本符合要求，或清除构建目录。
- 图像处理问题：确保图像格式支持且包含清晰可读的文本。
使用教程
使用依赖
- Node.js 16 或更高版本
- TypeScript 5.3 或更高版本
- 启用了 Calendar API 的 Google Cloud 项目
- OAuth 2.0 凭证（Client ID 和 Client Secret）
安装教程
- 克隆仓库
- 安装依赖：
bash npm install - 构建 TypeScript 代码：
bash npm run build - 从 Google Cloud Console 下载 OAuth 凭证，重命名为
gcp-oauth.keys.json并放置在项目根目录。
调试方式
- 启动开发服务器：
bash npm run dev - 手动运行认证流程：
bash npm run auth - 构建并监视代码变化：
bash npm run build:watch