金大哥 - google-calendar-mcp-server-xke MCP 详情

article

README

🚀 谷歌日历 MCP 服务器

此 MCP 服务器可与 Google 日历集成，借助统一接口，让 Claude 能够查看、创建和管理日历事件。

🚀 快速开始

本 MCP 服务器可实现与 Google 日历的集成，使 Claude 能通过统一接口对日历事件进行查看、创建和管理等操作。

✨ 主要特性

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

📦 安装指南

先决条件

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

Google Cloud 设置

访问 Google Cloud Console
创建新项目或选择现有项目
启用 Google 日历 API
创建 OAuth 2.0 凭证：
- 转到凭证
- 点击 “创建凭证” > “OAuth 客户端 ID”
- 选择 “桌面应用” 作为应用类型
- 给它一个名称（例如，“Google 日历 MCP”）
- 下载凭证 JSON 文件
- 将下载的文件重命名为 gcp-oauth.keys.json 并放在该项目根目录中

安装步骤

安装依赖项：
```
npm install
```
构建 TypeScript 代码：
```
npm run build
```

更新 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 日历 MCP 服务器时，它会：

检测到您没有认证令牌
启动一个认证服务器（在端口 3000 - 3004 上）
打开浏览器窗口进行 OAuth 认证
安全保存认证令牌
关闭认证服务器并继续正常运行

您的认证令牌将存储在 .gcp-saved-tokens.json 中，并会自动刷新。

💻 使用示例

基础用法

列出日历

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"

更新事件

update-event
eventID: "eventId123"
calendarId: "primary"
summary: "更新的团队会议"
description: "更新后的会议描述"

删除事件

delete-event
eventID: "eventId123"
calendarId: "primary"

📚 详细文档

可用工具

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

⚠️ 故障排除

如果无法连接到 Google 日历，检查网络连接和 API 权限。
确保 gcp-oauth.keys.json 文件存在且配置正确。

google-calendar-mcp-server-xke