AI导哈

日历事件管理服务

提供与Google Calendar的集成，允许用户查看、创建和管理日历事件。

  • by KhryptorGraphics
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 khryptorgraphics/google-calendar-mcp

使用说明

谷歌日历MCP服务器

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

特性

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

先决条件

  • Node.js 16或更高版本
  • 启用日历API的谷歌云项目
  • OAuth 2.0凭据（客户端ID和客户端密钥）

谷歌云设置

  1. 转到 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用 谷歌日历API
  4. 创建OAuth 2.0凭据：
    • 首选 凭证
    • 点击 “创建凭据”>“OAuth客户端ID”
    • 选择 “桌面应用程序” 作为应用程序类型
    • 为其命名（例如，“谷歌日历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 列出特定日历中的事件
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: ["colleague1@example.com", "colleague2@example.com"]

更新事件

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；确保至少有一个可用。

相关 MCP