MCP Tools Reference: calendarmcp.googleapis.com

Инструмент: list_calendars

Возвращает календари, к которым имеет доступ этот пользователь (его список календарей). Используйте этот инструмент для преобразования идентификационных данных календаря (например, «мой семейный календарь») в соответствующий calendar_id (идентификатор электронной почты).

В следующем примере показано, как использовать curl для вызова инструмента MCP list_calendars .

Запрос Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_calendars",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

ListCalendarsRequest

JSON-представление 
{

  "pageSize": integer

  "pageToken": string
}
Поля

Объединенное поле _page_size .

_page_size может принимать только одно из следующих значений:

pageSize

integer

Необязательно. Максимальное количество результатов на странице. По умолчанию 100 , максимум 250 .

Поле объединения _page_token .

_page_token может принимать только одно из следующих значений:

pageToken

string

Необязательный параметр. Токен, указывающий, какую страницу результатов следует вернуть.

Схема вывода

ListCalendarsResponse

JSON-представление 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Поля
calendars[]

object ( CalendarListItem )

Список календарей.

Поле объединения _next_page_token .

_next_page_token может принимать только одно из следующих значений:

nextPageToken

string

Токен следующей страницы. Опускается, если следующая страница отсутствует.

Элемент календаря

JSON-представление 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Поля
id

string

Идентификатор. Адрес электронной почты календаря.

summary

string

Только вывод. Заголовок.

description

string

Только вывод. Описание.

timeZone

string

Только для вывода. Часовой пояс.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.calendarlist
  • https://www.googleapis.com/auth/calendar.calendarlist.readonly