MCP Reference: calendarmcp.googleapis.com

这是由 Google 日历 API 提供的 MCP 服务器。该服务器为开发者提供了在日历之上构建 LLM 应用的工具。

Model Context Protocol (MCP) 服务器充当外部服务（为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能）与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统，并将这些系统的响应转换为 AI 应用可理解的格式。

服务器设置

您必须先配置日历 MCP 服务器，然后才能使用。如需详细了解如何使用 Google 和 Google Cloud 远程 MCP 服务器，请参阅 Google Cloud MCP 服务器概览。

服务器端点

MCP 服务端点是 MCP 服务器的网络地址和通信接口（通常是网址），AI 应用（MCP 客户端的宿主）使用该端点来建立安全、标准化的连接。它是 LLM 请求上下文、调用工具或访问资源的交互点。Google MCP 端点可以是全球性的，也可以是区域性的。

日历 API MCP 服务器具有以下全球 MCP 端点：

  • https://calendarmcp.googleapis.com/mcp/v1

MCP 工具

MCP 工具是 MCP 服务器向 LLM 或 AI 应用公开的函数或可执行功能，用于在现实世界中执行操作。

工具

calendarmcp.googleapis.com MCP 服务器具有以下工具：

MCP 工具
list_events

列出给定日历中满足给定条件的日历活动。

主要特性：

  • 任何日历 ID，可以是用户的主日历或其他日历。
  • 关键字匹配。
  • 时间范围过滤。
  • 检索与时间和关键字限制条件匹配的所有活动。

在以下情况下，请改用 search_events 工具：

  • 您需要查找（前 K 个）最相关的活动，而不是满足限制条件的所有活动。
  • 您需要语义搜索功能。
  • 您仅在用户的主日历中搜索特定信息。

此工具适用于以下查询：

  • 我明天有哪些日程安排？
  • 我在 2025 年 7 月 14 日有哪些日程安排？
  • 我下周有哪些会议？
  • 我今天下午的日程有没有冲突？

示例：

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.
get_event

从给定日历返回单个活动。

此工具适用于以下查询：

  • 获取团队会议的详细信息。
  • 在我的日历中显示 ID 为 event123 的活动。

示例：

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
list_calendars

返回用户日历列表中的日历。

此工具适用于以下查询：

  • 我的所有日历是什么？

示例：

list_calendars()
# Returns all calendars the authenticated user has access to.
suggest_time

建议一个或多个日历中的时间段。如需访问主日历，请在 attendee_emails 字段中添加“primary”。

此工具适用于以下查询：

  • 我们所有人何时都有空开会？
  • 查找一个 30 分钟的时间段，让我们两人都有空。
  • 查看 jane.doe@google.com 周一上午是否有空。

示例：

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.
create_event

创建日历活动。

此工具适用于以下查询：

  • 在我的日历中创建一个名为“与 Jane 的会议”的活动，时间为明天下午 2 点。
  • 安排与 john.doe@google.com 的会议，时间为下周一上午 10 点至 11 点。

示例：

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
update_event

更新日历活动。

此工具适用于以下查询：

  • 将“与 Jane 的会议”活动更新为一小时后。
  • 将 john.doe@google.com 添加到明天的会议中。

示例：

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.
delete_event

删除日历活动。

此工具适用于以下查询：

  • 删除我的日历中 ID 为 event123 的活动。

如需取消或拒绝活动，请改用 respond_to_event 工具。

示例：

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
respond_to_event

回应活动。

此工具适用于以下查询：

  • 接受我的日历中 ID 为 event123 的活动。
  • 拒绝与 Jane 的会议。
  • 取消我的下一个会议。
  • 暂时接受计划会议。

示例：

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.

获取 MCP 工具规范

如需获取 MCP 服务器中所有工具的 MCP 工具规范，请使用 tools/list 方法。下面的示例演示了如何使用 curl 列出 MCP 服务器中当前可用的所有工具及其规范。

Curl 请求 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'