MCP Reference: calendarmcp.googleapis.com

Ein Model Context Protocol (MCP)-Server 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.

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.

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 Termine ab, die den Zeit- und Keyword-Einschränkungen entsprechen.

Verwenden Sie stattdessen das Tool search_events, wenn:

  • Sie die (K) relevantesten Termine und nicht alle Termine 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:

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

Beispiel:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=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 einen einzelnen Termin aus einem bestimmten Kalender zurück.

Verwenden Sie dieses Tool für Abfragen wie:

  • Details zur Teambesprechung abrufen.
  • Zeige mir den Termin mit der ID event123 in meinem Kalender.

Beispiel:

get_event(
    event_id='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“ „primary“ hinzu.

Verwenden Sie dieses Tool für Abfragen wie:

  • Wann haben wir alle Zeit für eine Besprechung?
  • Suche einen 30-minütigen Zeitraum, in dem wir beide verfügbar sind.
  • Ist jane.doe@google.com am Montagmorgen verfügbar?

Beispiel:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': 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',
    start_time='2024-09-17T14:00:00',
    end_time='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(
    event_id='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(
    event_id='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(
    event_id='event123',
    response_status='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' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'