Google Calendar MCP 服务器

此 MCP 服务器提供与 Google 日历的集成，允许 Claude 通过标准化接口查看、创建和管理日历事件。

功能

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

前提条件

• Node.js 16 或更高版本
• 启用了 Calendar API 的 Google Cloud 项目
• OAuth 2.0 凭据（客户端 ID 和客户端密钥）

Google Cloud 设置

1. 转到 Google Cloud Console
2. 创建一个新项目或选择一个现有项目
3. 启用 Google Calendar API
4. 创建 OAuth 2.0 凭据：
   • 转到凭据
   • 点击**“创建凭据” > “OAuth 客户端 ID”**
   • 选择**“桌面应用”**作为应用程序类型
   • 给它一个名称（例如，“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: "团队会议"
location: "会议室 B"
description: "每周团队同步会议"
startDateTime: "2023-06-15T10:00:00"
endDateTime: "2023-06-15T11:00:00"
timeZone: "America/New_York"
attendees: ["colleague1@example.com", "colleague2@example.com"]

更新事件

update-event
calendarId: "primary"
eventId: "event_id_from_list_events"
summary: "更新后的会议标题"
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；确保至少有一个可用。