MCP Tools Reference: calendarmcp.googleapis.com

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

Предлагает временные периоды в рамках одного или нескольких календарей.

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

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

Схема ввода

Запрос сообщения для SuggestTime.

SuggestTimeRequest

JSON-представление 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
Поля
attendeeEmails[]

string

Обязательно. Необходимо указать адреса электронной почты участников, чтобы найти свободное время.

startTime

string

Обязательно. Начало интервала запросов (ISO 8601).

endTime

string

Обязательно. Конец интервала запросов (ISO 8601).

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

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

timeZone

string

Необязательный параметр. Часовой пояс для времени поиска (ID IANA, например Europe/Zurich ). По умолчанию: смещение start_time , если нет, то основной часовой пояс пользователя.

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

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

durationMinutes

integer

Необязательно. Минимальная продолжительность свободного слота в минутах. По умолчанию: 30 .

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

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

preferences

object ( Preferences )

Настройки для поиска рекомендуемого времени.

Настройки

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

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Поля

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

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

startHour

string

Предпочтительное время начала отсчета — "ЧЧ:мм" (24-часовой формат).

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

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

endHour

string

Предпочтительное время окончания — "ЧЧ:мм" (24-часовой формат).

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

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

excludeWeekends

boolean

Исключая выходные дни.

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

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

pageSize

integer

Максимальное количество возвращаемых слотов. По умолчанию: 5 .

Схема вывода

Ответное сообщение для SuggestTime.

SuggestTimeResponse

JSON-представление 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Поля
timeSlots[]

object ( TimeSlot )

Рекомендуемые временные интервалы.

Временной интервал

JSON-представление 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Поля
startTime
(deprecated)

string

Устарело: используйте start вместо неё.

endTime
(deprecated)

string

Устарело: используйте end вместо этого.

durationMinutes
(deprecated)

integer

Устарело: для вычисления продолжительности используйте вместо этого start и end .

start

object ( DateOrDateTime )

Время начала временного интервала.

end

object ( DateOrDateTime )

Время окончания временного интервала.

Дата или Дата/Время

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

string

Дата по стандарту ISO 8601 в полночь по UTC (например, '2019-11-20T00:00:00Z' ).

dateTime

string

Временная метка ISO 8601 (например, '2019-11-20T08:19:06-07:00' ).

timeZone

string

Название часового пояса в базе данных TZDB.

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

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