MCP Google Calendar Server
2025.03.19
27
JavaScript日程管理AI 助手集成日程管理
MCP Google Calendar Server 是一个基于 Model Context Protocol (MCP) 的服务实现，旨在使 AI 助手（如 Claude）能够创建和管理 Google Calendar 事件。该服务提供了与 Google Calendar API 的集成，支持创建事件、添加参与者等功能，并通过 OAuth2 认证确保安全性。
View on GitHub
Overview
基本能力
产品定位
MCP Google Calendar Server 是一个专门为 AI 助手设计的日程管理服务，通过 MCP 协议与 Google Calendar API 集成，实现日程的自动化管理。
核心功能
- 创建日历事件（包括标题、描述、开始/结束时间）
- 支持添加事件参与者
- 通过 OAuth2 认证与 Google Calendar API 集成
- 完整的 MCP 协议实现
- 调试日志记录，便于故障排查
适用场景
- AI 助手自动化管理用户日程
- 团队协作中的日程安排自动化
- 个人日程的自动化管理
工具列表
npm run auth: 用于获取 OAuth2 的刷新令牌npm start: 启动服务
常见问题解答
- 如何获取 Google OAuth2 凭证？需要在 Google Cloud Console 项目中启用 Calendar API 并创建 OAuth2 凭证。
- 如何调试服务？可以通过查看调试日志来排查问题。
使用教程
使用依赖
- Node.js v18 或更高版本
- Google Cloud Console 项目（已启用 Calendar API）
- OAuth2 凭证（Client ID 和 Client Secret）
安装教程
- 克隆仓库：
git clone https://github.com/markelaugust74/mcp-google-calendar.git
cd mcp-google-calendar
- 安装依赖：
npm install
- 设置环境变量：
- 复制 .env.example 到 .env
- 添加你的 Google OAuth2 凭证
- 获取刷新令牌：
npm run auth
- 在 index.js 中更新刷新令牌
调试方式
启动服务后，可以通过查看日志来调试：
npm start