MCP Tools Reference: calendarmcp.googleapis.com

Ferramenta: suggest_time

Sugere períodos em um ou mais calendários.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP suggest_time.

Solicitação 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": "suggest_time",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para SuggestTime.

SuggestTimeRequest

Representação JSON 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
Campos
attendeeEmails[]

string

Obrigatório. E-mails dos convidados para encontrar horários livres.
startTime

string

Obrigatório. Início do intervalo de consulta (ISO 8601).
endTime

string

Obrigatório. Fim do intervalo de consulta (ISO 8601).

Campo de união _time_zone.

_time_zone pode ser apenas de um dos tipos a seguir:
timeZone

string

Opcional. Fuso horário para horários de pesquisa (ID da IANA, por exemplo, Europe/Zurich). Padrão: o deslocamento de start_time, se não houver, o fuso horário principal do usuário.

Campo de união _duration_minutes.

_duration_minutes pode ser apenas de um dos tipos a seguir:
durationMinutes

integer

Opcional. Duração mínima do horário livre em minutos. Padrão: 30.

Campo de união _preferences.

_preferences pode ser apenas de um dos tipos a seguir:
preferences

object (Preferences)

Preferências para encontrar o horário sugerido.

Preferências

Representação JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Campos

Campo de união _start_hour.

_start_hour pode ser apenas de um dos tipos a seguir:
startHour

string

Horário de início preferido como "HH:mm" (formato de 24 horas).

Campo de união _end_hour.

_end_hour pode ser apenas de um dos tipos a seguir:
endHour

string

Horário de término preferido como "HH:mm" (formato de 24 horas).

Campo de união _exclude_weekends.

_exclude_weekends pode ser apenas de um dos tipos a seguir:
excludeWeekends

boolean

Excluir fins de semana.

Campo de união _page_size.

_page_size pode ser apenas de um dos tipos a seguir:
pageSize

integer

Número máximo de horários a serem retornados. Padrão: 5.

Esquema de saída

Mensagem de resposta para SuggestTime.

SuggestTimeResponse

Representação JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Campos
timeSlots[]

object (TimeSlot)

Horários sugeridos.

TimeSlot

Representação JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Campos
startTime
(deprecated)

string

Descontinuado: use start.
endTime
(deprecated)

string

Descontinuado: use end.
durationMinutes
(deprecated)

integer

Descontinuado: use start e end para calcular a duração.
start

object (DateOrDateTime)

O horário de início do horário.
end

object (DateOrDateTime)

O horário de término do horário.

DateOrDateTime

Representação JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Campos
date

string

Data ISO 8601 à meia-noite UTC (por exemplo, '2019-11-20T00:00:00Z').
dateTime

string

Timestamp ISO 8601 (por exemplo, '2019-11-20T08:19:06-07:00').
timeZone

string

Nome do fuso horário TZDB.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.freebusy
  • https://www.googleapis.com/auth/calendar.freebusy