
Google Calendar MCP Server

Overview
基本能力
产品定位
Google Calendar MCP Server 是一个与 Google Calendar 集成的服务,旨在通过标准化接口提供日历事件的管理功能。
核心功能
- 列出可用日历
- 列出日历中的事件
- 创建新的日历事件
- 更新现有事件
- 删除事件
适用场景
- 自动化日程管理
- 团队会议安排
- 个人日程提醒
工具列表
工具 | 描述 |
---|---|
list-calendars |
列出所有可用日历 |
list-events |
列出特定日历中的事件 |
create-event |
创建新的日历事件 |
update-event |
更新现有日历事件 |
delete-event |
删除日历事件 |
常见问题解答
- OAuth token expires after 7 days: 如果应用处于测试模式,您必须重新认证。
- Authentication errors: 确保
gcp-oauth.keys.json
格式正确并放置在项目根目录。 - Port conflicts: 认证服务器尝试使用端口 3000-3004;确保至少有一个端口可用。
使用教程
使用依赖
- Node.js 16 或更高版本
- 启用了 Calendar API 的 Google Cloud 项目
- OAuth 2.0 凭证(Client ID 和 Client Secret)
安装教程
-
安装依赖:
npm install
-
构建 TypeScript 代码:
npm run build
-
更新 Claude MCP 设置文件以包含此服务器:
- 在
cline_mcp_settings.json
中添加以下内容:json "github.com/pashpashpash/google-calendar-mcp": { "command": "node", "args": ["C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"], "env": {}, "disabled": false, "autoApprove": [] }
调试方式
-
列出日历:
list-calendars
-
列出事件:
list-events calendarId: "primary" timeMin: "2023-01-01T00:00:00Z" timeMax: "2023-12-31T23:59:59Z" maxResults: 10
-
创建事件:
create-event calendarId: "primary" summary: "Team Meeting" location: "Conference Room B" description: "Weekly team sync meeting" startDateTime: "2023-06-15T10:00:00" endDateTime: "2023-06-15T11:00:00" timeZone: "America/New_York" attendees: ["[email protected]", "[email protected]"]
-
更新事件:
update-event calendarId: "primary" eventId: "event_id_from_list_events" summary: "Updated Meeting Title" startDateTime: "2023-06-15T11:00:00" endDateTime: "2023-06-15T12:00:00"
-
删除事件:
delete-event calendarId: "primary" eventId: "event_id_from_list_events"
许可证
None