MCP Google Calendar Server
2025.04.01
0
TypeScript日历服务日程管理日程管理
MCP Google Calendar Server是基于MCP(Model Context Protocol)的Google Calendar集成服务，旨在为Claude Desktop等MCP客户端提供与Google Calendar的交互能力。该服务支持Google OAuth 2.0认证、日历事件的添加和查询、今日日期查询等功能，并特别支持韩国时区(KST)和详细的错误处理与日志记录。
View on GitHub
Overview
基本能力
产品定位
MCP Google Calendar Server是一个集成Google Calendar的服务，旨在通过MCP协议为客户端提供日历管理功能。
核心功能
- Google OAuth 2.0认证
- Google Calendar事件添加
- Google Calendar事件查询（支持按时间段查询）
- 今日日期查询
- 韩国时区(KST)支持
- 详细的错误处理和日志记录
适用场景
- 个人日程管理
- 团队协作中的日程安排
- 需要与Google Calendar集成的桌面应用
工具列表
- googleAuthLogin: 执行Google Calendar API认证。
- addCalendarEvent: 向Google Calendar添加新事件。
- listCalendarEvents: 查询特定时间段内的Google Calendar事件。
- getTodayDate: 返回当前日期（YYYY-MM-DD格式）。
常见问题解答
- 服务器连接问题: 检查Claude Desktop日志、服务器进程状态、环境变量设置和绝对路径使用情况。
- 认证问题: 确认Google Cloud Console中的API激活状态、客户端ID和密钥、OAuth同意屏幕设置。
使用教程
使用依赖
- 克隆仓库并进入项目目录：
git clone [repository-url]
cd mcp-server-google-calendar
- 安装依赖：
npm install
- 设置环境变量：
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
安装教程
- 在Google Cloud Console中创建新项目并激活Google Calendar API。
- 创建OAuth 2.0客户端ID（应用类型选择“桌面应用”）。
- 将生成的客户端ID和密钥添加到
.env文件。
调试方式
- 查看实时日志：
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
- 激活开发者工具：
echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
然后使用Command-Option-Shift-i打开开发者工具。