Google Calendar MCP Server

Google Calendar MCP 服务

此 MCP 服务可与 Google Calendar 集成，让 Claude 通过标准化接口查看、创建和管理日历活动。

功能

• 列出可用日历
• 列出日历中的活动
• 创建新的日历活动
• 更新现有活动
• 删除活动

前提条件

• Node.js 16 或更高版本
• 已启用 Calendar API 的 Google Cloud 项目
• OAuth 2.0 凭据（Client ID 和 Client Secret）

Google Cloud 设置

1. 前往 Google Cloud 控制台
2. 创建新项目或选择现有项目
3. 启用 Google Calendar API
4. 创建 OAuth 2.0 凭据：
   • 前往 Credentials
   • 点击 "Create Credentials" > "OAuth client ID"
   • 将 "Desktop app" 选为应用类型
   • 为其命名（例如 "Google Calendar MCP"）
   • 下载凭据 JSON 文件
   • 将下载的文件重命名为 gcp-oauth.keys.json，并放在此项目的根目录中

安装

1. 安装依赖项：

   npm install
   

2. 构建 TypeScript 代码：

   npm run build
   

3. 更新 Claude MCP 设置文件以包含此服务：

   • 将以下内容添加到 cline_mcp_settings.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": []
   }
   

身份验证流程

首次使用 Google Calendar MCP 服务时，它将：

1. 检测到你尚无身份验证令牌
2. 启动身份验证服务（使用 3000-3004 端口）
3. 打开浏览器窗口进行 OAuth 身份验证
4. 安全地保存身份验证令牌
5. 关闭身份验证服务并继续正常运行

身份验证令牌将存储在 .gcp-saved-tokens.json 中，并会自动刷新。

可用工具

工具	描述
list-calendars	列出所有可用日历
list-events	列出特定日历中的活动
create-event	创建新的日历活动
update-event	更新现有日历活动
delete-event	删除日历活动

示例

列出日历

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"

故障排除

• OAuth 令牌 7 天后过期：如果应用处于测试模式，则必须重新进行身份验证。
• 身份验证错误：确保 gcp-oauth.keys.json 格式正确，并放在项目根目录中。
• 端口冲突：身份验证服务会尝试使用 3000-3004 端口；请确保至少有一个端口可用。