Google Calendar MCP Server

基本能力

产品定位

Google Calendar MCP Server 是一个日历集成服务，旨在通过标准化接口简化与 Google Calendar 的交互，支持多种动态和多步骤的日历操作。

核心功能

1. 事件管理：读取、创建、更新和搜索日历事件。
2. 图片识别：从 PNG、JPEG、GIF 格式的图片中提取事件详情（日期、时间、地点、描述）并添加到日历。
3. 日历分析：分析即将到来的非例行事件。
4. 出席检查：检查未接受邀请的参会者。
5. 自动协调：根据可用时间自动创建事件。
6. 可用时间查询：结合个人和工作日历提供可用时间。

适用场景

1. 个人日程管理：快速添加和管理个人日程。
2. 团队协作：协调团队会议时间并检查出席情况。
3. 自动化任务：通过图片或文本自动创建和更新事件。
4. 时间分析：分析日程安排，优化时间管理。

工具列表

1. npm run build：编译 TypeScript 代码。
2. npm run typecheck：运行 TypeScript 类型检查。
3. npm run start：启动编译后的服务器。
4. npm run dev：在开发模式下启动服务器（实时监听更改）。
5. npm run auth：手动启动 Google OAuth 认证服务器。
6. npm test：运行单元/集成测试。
7. npm run test:watch：在监听模式下运行测试。
8. npm run coverage：生成测试覆盖率报告。

常见问题解答

1. OAuth 令牌过期：测试模式下令牌每周过期，需重新认证。
2. 认证失败：检查 gcp-oauth.keys.json 文件是否存在且有效，或删除 .gcp-saved-tokens.json 重新认证。
3. 构建错误：重新运行 npm install 或检查 Node.js 版本。

使用教程

使用依赖

1. Node.js（推荐最新 LTS 版本）
2. TypeScript 5.3 或更高版本
3. Google Cloud 项目（已启用 Calendar API）
4. OAuth 2.0 凭证（Client ID 和 Client Secret）

安装教程

1. 克隆仓库。
2. 安装依赖（自动构建 JS）： bash npm install
3. 从 Google Cloud Console 下载 OAuth 凭证，重命名为 gcp-oauth.keys.json 并放置在项目根目录。

调试方式

1. 启动服务器： bash npm start 或开发模式： bash npm run dev
2. 手动认证（如需）： bash npm run auth
3. 运行测试： bash npm test

许可证

该项目遵循 MIT 开源许可条款。