🚀 谷歌日历 MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

先决条件

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

Google Cloud 设置

1. 访问 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 Google 日历 API
4. 创建 OAuth 2.0 凭证：
   • 转到 凭证
   • 点击 “创建凭证” > “OAuth 客户端 ID”
   • 选择 “桌面应用” 作为应用类型
   • 给它一个名称（例如，“Google 日历 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 日历 MCP 服务器时，它会：

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

您的认证令牌将存储在 .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"

📚 详细文档

可用工具

⚠️ 故障排除

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