MCP Tools Reference: calendarmcp.googleapis.com

Tool: list_calendars

Gibt die Kalender zurück, auf die dieser Nutzer Zugriff hat (seine Kalenderliste). Mit diesem Tool können Sie Kalender-Identifikationsdaten (z. B. „Mein Familienkalender“) in die entsprechende calendar_id (E-Mail-ID) auflösen.

Im folgenden Beispiel wird gezeigt, wie Sie das MCP-Tool list_calendars mit curl 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": "list_calendars",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

ListCalendarsRequest

JSON-Darstellung 
{

  "pageSize": integer

  "pageToken": string
}
Felder

Union-Feld _page_size.

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

integer

Optional. Maximale Anzahl der Ergebnisse pro Seite. Standardwert: 100, Maximum: 250.

Union-Feld _page_token.

Für _page_token ist nur einer der folgenden Werte zulässig:
pageToken

string

Optional. Token, das angibt, welche Ergebnisseite zurückgegeben werden soll.

Ausgabeschema

ListCalendarsResponse

JSON-Darstellung 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Felder
calendars[]

object (CalendarListItem)

Liste der Kalender.

Union-Feld _next_page_token.

Für _next_page_token ist nur einer der folgenden Werte zulässig:
nextPageToken

string

Token für nächste Seite Wird ausgelassen, wenn keine nächste Seite vorhanden ist.

CalendarListItem

JSON-Darstellung 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Felder
id

string

ID. E-Mail-Adresse des Kalenders.
summary

string

Nur Ausgabe. Titel
description

string

Nur Ausgabe. Beschreibung:
timeZone

string

Nur Ausgabe. Zeitzone

Tool-Anmerkungen

Destruktiv: ❌ | Idempotent: ✅ | Schreibgeschützt: ✅ | 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.calendarlist
  • https://www.googleapis.com/auth/calendar.calendarlist.readonly