Google Calendar MCP Server

Google Calendar MCP Server

site icon
2025.03.15 0
TypeScript日程管理日程管理
Google Calendar MCP Server 是一个与 Google Calendar 集成的服务,允许用户通过标准化接口查看、创建和管理日历事件。它提供了列出日历、列出事件、创建、更新和删除事件等核心功能,适用于需要自动化管理日程的场景。
View on GitHub

Overview

基本能力

产品定位

Google Calendar MCP Server 是一个与 Google Calendar 集成的服务,旨在通过标准化接口提供日历事件的管理功能。

核心功能

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

适用场景

  • 自动化日程管理
  • 团队会议安排
  • 个人日程提醒

工具列表

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

常见问题解答

  • OAuth token expires after 7 days: 如果应用处于测试模式,您必须重新认证。
  • Authentication errors: 确保 gcp-oauth.keys.json 格式正确并放置在项目根目录。
  • Port conflicts: 认证服务器尝试使用端口 3000-3004;确保至少有一个端口可用。

使用教程

使用依赖

  • Node.js 16 或更高版本
  • 启用了 Calendar API 的 Google Cloud 项目
  • OAuth 2.0 凭证(Client ID 和 Client Secret)

安装教程

  1. 安装依赖: npm install

  2. 构建 TypeScript 代码: npm run build

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

  4. cline_mcp_settings.json 中添加以下内容: 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": [] }

调试方式

  1. 列出日历: list-calendars

  2. 列出事件: list-events calendarId: "primary" timeMin: "2023-01-01T00:00:00Z" timeMax: "2023-12-31T23:59:59Z" maxResults: 10

  3. 创建事件: 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]"]

  4. 更新事件: 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"

  5. 删除事件: delete-event calendarId: "primary" eventId: "event_id_from_list_events"

许可证

None