MCP Tools Reference: calendarmcp.googleapis.com

Outil : suggest_time

Suggère des périodes sur un ou plusieurs calendriers.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP suggest_time.

Requête 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
}'

Schéma d'entrée

Message de requête pour SuggestTime.

SuggestTimeRequest

Représentation JSON 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

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

string

Obligatoire. Adresses e-mail des participants pour lesquels trouver des disponibilités.
startTime

string

Obligatoire. Début de l'intervalle de requête (ISO 8601).
endTime

string

Obligatoire. Fin de l'intervalle de requête (ISO 8601).

Champ d'union _time_zone.

_time_zone ne peut être qu'un des éléments suivants :
timeZone

string

Facultatif. Fuseau horaire pour les heures de recherche (ID IANA, par exemple Europe/Zurich). Valeur par défaut : décalage de start_time, ou fuseau horaire principal de l'utilisateur si aucun décalage n'est défini.

Champ d'union _duration_minutes.

_duration_minutes ne peut être qu'un des éléments suivants :
durationMinutes

integer

Facultatif. Durée minimale du créneau disponible en minutes. Valeur par défaut : 30.

Champ d'union _preferences.

_preferences ne peut être qu'un des éléments suivants :
preferences

object (Preferences)

Préférences pour trouver l'heure suggérée.

Préférences

Représentation JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Champs

Champ d'union _start_hour.

_start_hour ne peut être qu'un des éléments suivants :
startHour

string

Heure de début préférée au format "HH:mm" (format 24 heures).

Champ d'union _end_hour.

_end_hour ne peut être qu'un des éléments suivants :
endHour

string

Heure de fin préférée au format "HH:mm" (format 24 heures).

Champ d'union _exclude_weekends.

_exclude_weekends ne peut être qu'un des éléments suivants :
excludeWeekends

boolean

Exclure les week-ends.

Champ d'union _page_size.

_page_size ne peut être qu'un des éléments suivants :
pageSize

integer

Nombre maximal de créneaux à renvoyer. Valeur par défaut : 5.

Schéma de sortie

Message de réponse pour SuggestTime.

SuggestTimeResponse

Représentation JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Champs
timeSlots[]

object (TimeSlot)

Créneaux suggérés.

TimeSlot

Représentation JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Champs
startTime
(deprecated)

string

Obsolète : utilisez start à la place.
endTime
(deprecated)

string

Obsolète : utilisez end à la place.
durationMinutes
(deprecated)

integer

Obsolète : utilisez start et end pour calculer la durée à la place.
start

object (DateOrDateTime)

Heure de début du créneau.
end

object (DateOrDateTime)

Heure de fin du créneau.

DateOrDateTime

Représentation JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Champs
date

string

Date ISO 8601 à minuit UTC (par exemple, '2019-11-20T00:00:00Z')
dateTime

string

Timestamp ISO 8601 (par exemple, '2019-11-20T08:19:06-07:00')
timeZone

string

Nom du fuseau horaire TZDB.

Annotations d'outil

Indication destructive : ❌ | Indication d'idempotence : ✅ | Indication en lecture seule : ✅ | Indication de monde ouvert : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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