MCP Tools Reference: calendarmcp.googleapis.com

Tool: suggest_time

Schlägt Zeiträume in einem oder mehreren Kalendern vor.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool suggest_time aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für SuggestTime

SuggestTimeRequest

JSON-Darstellung 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

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

string

Erforderlich. E‑Mail-Adressen der Teilnehmer, für die kostenlose Zeit gesucht werden soll.
startTime

string

Erforderlich. Start des Abfrageintervalls (ISO 8601).
endTime

string

Erforderlich. Ende des Abfrageintervalls (ISO 8601).

Union-Feld _time_zone.

Für _time_zone ist nur einer der folgenden Werte zulässig:
timeZone

string

Optional. Zeitzone für Suchzeiten (IANA-ID, z. B. Europe/Zurich). Standard: der Offset von start_time, falls keiner vorhanden ist, die primäre Zeitzone des Nutzers.

Union-Feld _duration_minutes.

Für _duration_minutes ist nur einer der folgenden Werte zulässig:
durationMinutes

integer

Optional. Mindestdauer des kostenlosen Zeitfensters in Minuten. Standard: 30.

Union-Feld _preferences.

Für _preferences ist nur einer der folgenden Werte zulässig:
preferences

object (Preferences)

Einstellungen für die Suche nach vorgeschlagenen Uhrzeiten.

Einstellungen

JSON-Darstellung 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Felder

Union-Feld _start_hour.

Für _start_hour ist nur einer der folgenden Werte zulässig:
startHour

string

Bevorzugte Startzeit im Format „HH:mm“ (24‑Stunden-Format).

Union-Feld _end_hour.

Für _end_hour ist nur einer der folgenden Werte zulässig:
endHour

string

Bevorzugte Endzeit als „HH:mm“ (24‑Stunden-Format).

Union-Feld _exclude_weekends.

Für _exclude_weekends ist nur einer der folgenden Werte zulässig:
excludeWeekends

boolean

Wochenenden ausschließen

Union-Feld _page_size.

Für _page_size ist nur einer der folgenden Werte zulässig:
pageSize

integer

Maximale Anzahl der zurückzugebenden Slots. Standard: 5.

Ausgabeschema

Antwortnachricht für SuggestTime

SuggestTimeResponse

JSON-Darstellung 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Felder
timeSlots[]

object (TimeSlot)

Vorgeschlagene Zeitfenster

TimeSlot

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Felder
startTime
(deprecated)

string

Verworfen. Verwenden Sie stattdessen start.
endTime
(deprecated)

string

Verworfen. Verwenden Sie stattdessen end.
durationMinutes
(deprecated)

integer

Verworfen: Verwenden Sie stattdessen start und end, um die Dauer zu berechnen.
start

object (DateOrDateTime)

Die Startzeit des Zeitfensters.
end

object (DateOrDateTime)

Die Endzeit des Zeitfensters.

DateOrDateTime

JSON-Darstellung 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Felder
date

string

ISO 8601-Datum um Mitternacht UTC (z. B. '2019-11-20T00:00:00Z').
dateTime

string

ISO 8601-Zeitstempel (z. B. '2019-11-20T08:19:06-07:00').
timeZone

string

TZDB-Zeitzonenname.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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