MCP Reference: calendarmcp.googleapis.com

Dies ist ein MCP-Server, der von der Google Calendar API bereitgestellt wird. Der Server bietet Tools für Entwickler, um LLM-Anwendungen auf Basis von Google Kalender zu erstellen.

Ein MCP-Server (Model Context Protocol) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung verstehen kann.

Server einrichten

Sie müssen den Calendar MCP-Server vor der Verwendung konfigurieren. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über die eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Calendar API hat den folgenden globalen MCP-Endpunkt:

  • https://calendarmcp.googleapis.com/mcp/v1

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

Tools

Der MCP-Server calendarmcp.googleapis.com hat die folgenden Tools:

MCP-Tools
list_events

Listet Kalendertermine in einem bestimmten Kalender auf, die die angegebenen Bedingungen erfüllen.

Wichtigste Funktionen:

  • Beliebige Kalender-ID, z. B. der primäre Kalender des Nutzers oder andere Kalender.
  • Keyword-Optionen.
  • Zeitraumfilter.
  • Ruft ALLE Ereignisse ab, die den Zeit- und Keyword-Einschränkungen entsprechen.

Verwenden Sie stattdessen das Tool search_events, wenn:

  • Sie die (K) relevantesten Ereignisse und nicht alle Ereignisse finden müssen, die die Einschränkungen erfüllen.
  • Sie semantische Suchfunktionen benötigen.
  • Sie nur den primären Kalender des Nutzers nach bestimmten Informationen durchsuchen.

Verwenden Sie dieses Tool für Abfragen wie:

  • Was steht morgen in meinem Kalender?
  • Was steht am 14. Juli 2025 in meinem Kalender?
  • Welche Besprechungen habe ich nächste Woche?
  • Habe ich heute Nachmittag Terminkonflikte?

Beispiel:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.
get_event

Gibt ein einzelnes Ereignis aus einem bestimmten Kalender zurück.

Verwenden Sie dieses Tool für Abfragen wie:

  • Details zur Teambesprechung abrufen.
  • Zeige mir das Ereignis mit der ID event123 in meinem Kalender.

Beispiel:

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
list_calendars

Gibt die Kalender in der Kalenderliste des Nutzers zurück.

Verwenden Sie dieses Tool für Abfragen wie:

  • Welche Kalender habe ich?

Beispiel:

list_calendars()
# Returns all calendars the authenticated user has access to.
suggest_time

Schlägt Zeiträume in einem oder mehreren Kalendern vor. Wenn Sie auf den primären Kalender zugreifen möchten, fügen Sie im Feld „attendee_emails“ (E-Mail-Adressen der Teilnehmer) „primary“ hinzu.

Verwenden Sie dieses Tool für Abfragen wie:

  • Wann haben wir alle Zeit für eine Besprechung?
  • Suche einen 30-Minuten-Termin, an dem wir beide Zeit haben.
  • Ist jane.doe@google.com am Montagmorgen verfügbar?

Beispiel:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.
create_event

Erstellt einen Kalendertermin.

Verwenden Sie dieses Tool für Abfragen wie:

  • Erstelle für morgen um 14:00 Uhr einen Termin in meinem Kalender mit dem Titel „Besprechung mit Jane“.
  • Plane für nächsten Montag von 10:00 bis 11:00 Uhr eine Besprechung mit john.doe@google.com.

Beispiel:

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
update_event

Aktualisiert einen Kalendertermin.

Verwenden Sie dieses Tool für Abfragen wie:

  • Verschiebe den Termin „Besprechung mit Jane“ um eine Stunde nach hinten.
  • Füge john.doe@google.com zur Besprechung morgen hinzu.

Beispiel:

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.
delete_event

Löscht einen Kalendertermin.

Verwenden Sie dieses Tool für Abfragen wie:

  • Lösche den Termin mit der ID event123 in meinem Kalender.

Verwenden Sie stattdessen das Tool respond_to_event, um einen Termin abzusagen oder abzulehnen.

Beispiel:

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
respond_to_event

Antwortet auf einen Termin.

Verwenden Sie dieses Tool für Abfragen wie:

  • Akzeptiere den Termin mit der ID event123 in meinem Kalender.
  • Lehne die Besprechung mit Jane ab.
  • Sage meine nächste Besprechung ab.
  • Akzeptiere die Planungsbesprechung vorläufig.

Beispiel:

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.

MCP-Tool-Spezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'