Calendar MCP-Server konfigurieren

Google Calendar bietet einen Remote- Model Context Protocol (MCP) Server, mit dem KI-Agenten sicher mit Calendar-Daten interagieren können. Wenn Sie den Calendar-MCP-Server konfigurieren, können KI-Anwendungen wie Google Antigravity und Claude Aktionen in Calendar ausführen.

Der Calendar-MCP-Server bietet KI-Agenten eine standardisierte Möglichkeit für folgende Aktionen:

  • Daten lesen: Kalender auflisten, Termine abrufen und Verfügbarkeit prüfen.
  • Aktionen ausführen: Termine erstellen, aktualisieren und löschen.
  • Sicherheit beachten: Dieselben Berechtigungen und Data Governance-Kontrollen wie der Nutzer übernehmen.

Vorbereitung

Calendar-MCP-Server konfigurieren

Wenn Sie den Calendar-MCP-Server verwenden möchten, müssen Sie ihn in Ihrem Cloud-Projekt aktivieren und dann Ihren MCP-Client so konfigurieren, dass er eine Verbindung zu ihm herstellt.

APIs aktivieren

Wenn Sie den Calendar-MCP-Server verwenden möchten, müssen Sie die folgende API in Ihrem Cloud-Projekt aktivieren:

  • Google Calendar API

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

Console

Aktivieren Sie die APIs in der Console:

APIs aktivieren

MCP-Dienste aktivieren

Wenn Sie die MCP-Komponenten für Calendar aktivieren möchten, müssen Sie den folgenden Dienst in Ihrem Cloud-Projekt aktivieren:

  • Calendar MCP API

CLI

gcloud services enable calendarmcp.googleapis.com --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

Console

Aktivieren Sie die MCP-Dienste in der Console:

MCP-Dienste aktivieren

Der Calendar-MCP-Server verwendet OAuth 2.0 zur Authentifizierung und Autorisierung. Sie müssen den OAuth-Zustimmungsbildschirm konfigurieren, bevor Sie eine OAuth-Client-ID erstellen können.

  1. Rufen Sie in der Console Google Auth Platform > Branding auf.

    Zum Branding

  2. Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Google Auth Platform noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:

    1. Geben Sie unter Anwendungsinformationen in App-Name Calendar MCP Server ein.
    2. Wählen Sie unter E‑Mail-Adresse für Nutzersupport Ihre E‑Mail-Adresse oder eine geeignete Google-Gruppe aus.
    3. Klicken Sie auf Weiter.
    4. Wählen Sie unter Zielgruppe die Option Intern aus. Wenn Sie Intern nicht auswählen können, wählen Sie Extern aus.
    5. Klicken Sie auf Weiter.
    6. Geben Sie unter Kontaktdaten eine E‑Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
    7. Klicken Sie auf Weiter.
    8. Lesen Sie unter Abschließen die Richtlinie zu Nutzerdaten für Google API-Dienste . Wenn Sie damit einverstanden sind, wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus.
    9. Klicken Sie auf Weiter.
    10. Klicken Sie auf Erstellen.
    11. Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
      1. Klicken Sie auf Zielgruppe.
      2. Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
      3. Geben Sie Ihre E‑Mail-Adresse und die E‑Mail-Adressen aller anderen autorisierten Testnutzer ein und klicken Sie dann auf Speichern.

  3. Klicken Sie auf Datenzugriff > Bereiche hinzufügen oder entfernen. Ein Steuerfeld mit einer Liste der Bereiche für jede API, die Sie in Ihrem Cloud-Projekt aktiviert haben, wird angezeigt.

    1. Fügen Sie unter Bereiche manuell hinzufügen die Bereiche für den Calendar-MCP-Server ein:

      • https://www.googleapis.com/auth/calendar.calendarlist.readonly
      • https://www.googleapis.com/auth/calendar.events.freebusy
      • https://www.googleapis.com/auth/calendar.events.readonly

    2. Klicken Sie auf Zur Tabelle hinzufügen.

    3. Klicken Sie auf Aktualisieren.

    4. Klicken Sie auf der Seite Datenzugriff auf Speichern , nachdem Sie die für Ihre App erforderlichen Bereiche ausgewählt haben.

MCP-Client konfigurieren

Folgen Sie der Anleitung für Ihren Client, um den Remote-MCP-Server für Calendar zu Ihrem MCP-Client hinzuzufügen.

Antigravity

Wenn Sie den Remote-MCP-Server für Calendar zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration der Datei mcp_config.json hinzu. Diese Anleitung unterstützt Antigravity 2.0, Antigravity IDE und Antigravity CLI.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:

    1. Rufen Sie in der Console Google Auth Platform > Clients > Client erstellen auf.

      Zur Seite „Client erstellen“

    2. Wählen Sie als Anwendungstyp Webanwendung aus.

    3. Geben Sie einen Namen ein.

    4. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen, und fügen Sie dann https://antigravity.google/oauth-callback in das URIs Feld ein.

    5. Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihr Client-Secret.

  2. Öffnen oder erstellen Sie die Konfigurationsdatei ~/.gemini/antigravity/mcp_config.json.

  3. Fügen Sie die Konfiguration mcpServers zu mcp_config.json hinzu:

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Ersetzen Sie Folgendes:

    • OAUTH_CLIENT_ID: Die von Ihnen erstellte Client-ID.
    • OAUTH_CLIENT_SECRET: Das von Ihnen erstellte Client-Secret.

  4. Speichern Sie mcp_config.json.

  5. Authentifizieren Sie den MCP-Server entweder über die GUI-Einstellungen oder die Befehlszeile:

    • Für Antigravity IDE oder GUI (Antigravity 2.0):

      1. Öffnen Sie den Bildschirm mit den Einstellungen (klicken Sie z. B. unten links auf Einstellungen oder öffnen Sie die Antigravity-Nutzereinstellungen).
      2. Rufen Sie Anpassungen auf.
      3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
      4. Suchen Sie in der Liste nach calendar, klicken Sie auf Authentifizieren, melden Sie sich in Ihrem Google-Konto an, kopieren Sie den Autorisierungscode, fügen Sie ihn in das Eingabefeld ein und klicken Sie auf Senden.

    • Für Antigravity CLI:

      1. Starten Sie die Antigravity CLI:

        agy

      2. Öffnen Sie das interaktive MCP-Verwaltungssteuerfeld, indem Sie Folgendes ausführen:

        /mcp

      3. Wählen Sie mit den Pfeiltasten calendar aus, wechseln Sie zur Aktion Authentifizieren und drücken Sie die Eingabetaste. Schließen Sie den Anmeldevorgang in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminaleingabeaufforderung ein und drücken Sie die Eingabetaste.

  6. Prüfen Sie, ob der Server richtig konfiguriert ist und ausgeführt wird:

    • Für Antigravity IDE oder GUI: Unter Anpassungen > Installierte MCP-Server wird neben dem Server die Schaltfläche Abmelden angezeigt.
    • Für Antigravity CLI: Öffnen Sie das Steuerfeld /mcp, um Ihre konfigurierten MCP-Server zu sehen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Steuerfeld neben dem Namen Authed angezeigt. Sie können den Server in der Dashboardansicht auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.

Der Remote-MCP-Server kann jetzt in Antigravity verwendet werden.

Claude

Wenn Sie den Remote-MCP-Server für Calendar mit Claude.ai oder Claude Desktop verwenden möchten, benötigen Sie den Claude Enterprise-, Pro-, Max- oder Team-Tarif.

Wenn Sie den Remote-MCP-Server für Calendar zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem Secret.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:

    1. Rufen Sie in der Console Google Auth Platform > Clients > Client erstellen auf.

      Zur Seite „Client erstellen“

    2. Wählen Sie als Anwendungstyp Webanwendung aus.

    3. Geben Sie einen Namen ein.

    4. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen, und fügen Sie dann https://claude.ai/api/mcp/auth_callback in das URIs Feld ein.

    5. Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihr Client-Secret.

  2. Konfigurieren Sie den MCP-Server in Claude:

    1. Rufen Sie in Claude.ai oder Claude Desktop die Einstellungen (oder Verwaltungseinstellungen ) > Connectors auf.
    2. Klicken Sie auf Benutzerdefinierten Connector hinzufügen.
    3. Geben Sie die Verbindungsdetails für das Calendar-Produkt ein:
      • Server name: Calendar.
      • Remote-MCP-Server-URL: https://calendarmcp.googleapis.com/mcp/v1
    4. Geben Sie unter Erweiterte Einstellungen Ihre OAuth-Client-ID und Ihr OAuth-Client-Secret ein.
    5. Klicken Sie auf Hinzufügen.

Sonstiges

Viele KI-Anwendungen bieten Möglichkeiten, eine Verbindung zu einem Remote-MCP-Server herzustellen. In der Regel müssen Sie Details zum Server eingeben, z. B. Name, Endpunkte, Transportprotokoll und Authentifizierungsmethode. Geben Sie für den Remote-MCP-Server für Calendar Folgendes ein:

  • Server name: calendar

  • Server-URL: https://calendarmcp.googleapis.com/mcp/v1

  • Transport: HTTP

  • Authentifizierung: Der Remote-MCP-Server für Calendar verwendet OAuth 2.0. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung.

Weitere Informationen zum Verbinden verschiedener Clienttypen finden Sie unter MCP in einer KI-Anwendung konfigurieren.

Calendar-MCP-Server testen

Nachdem Sie den MCP-Client konfiguriert haben, können Sie die Verbindung prüfen, indem Sie einige Test-Prompts ausführen.

Stellen Sie Ihrem MCP-Client die folgenden Fragen:

  • "Wann ist mein nächstes Meeting mit Ariel?"

    Der Client prüft Ihren Zeitplan mit calendar.list_events und gibt Details zu Ihrem nächsten Meeting mit Ariel an.

Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten erhalten, ist Ihr Calendar-MCP-Server richtig konfiguriert.

Fehlerbehebung

Wenn Sie Probleme beim Herstellen einer Verbindung zum MCP-Server haben, suchen Sie in den OAuth-Logs nach Fehlern. Bitten Sie einen Administrator, die OAuth-Protokollereignisse im Sicherheitsprüftool zu prüfen.

Tool-Referenz

Die folgenden Tools sind für den Calendar-MCP-Server verfügbar:

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

Sicherheitsaspekt: Indirekte Prompt Injection

Wenn Sie ein Language Model nicht vertrauenswürdigen Daten aussetzen, besteht das Risiko eines indirekten Prompt-Injection-Angriffs. Da MCP-Hosts wie Google Antigravity über den Calendar-MCP-Server Zugriff auf leistungsstarke Tools und APIs haben, können sie Daten in Ihrem Google-Konto lesen, ändern und löschen.

Um diese Risiken zu minimieren, müssen Sie Prompts und Antworten auf schädliche Inhalte oder Prompt-Injection-Angriffe prüfen. Sie können Model Armor von Google verwenden oder Ihre eigene Lösung, wenn Sie sie dokumentieren, damit Nutzer dieses Risiko akzeptieren können. Weitere Informationen finden Sie unter Sicherheit für Google Workspace-MCP-Server konfigurieren.

Wir empfehlen folgende Best Practices:

  • Verwenden Sie nur vertrauenswürdige Tools. Verbinden Sie den Calendar-MCP-Server niemals mit nicht vertrauenswürdigen oder nicht verifizierten Anwendungen.
  • Seien Sie bei nicht vertrauenswürdigen Eingaben vorsichtig. Bitten Sie Ihren MCP-Client nicht, Termine oder andere Ressourcen aus nicht verifizierten Quellen zu verarbeiten. Diese Eingaben können verborgene Anweisungen enthalten, die Ihre Sitzung übernehmen können, sodass ein Angreifer Ihre Daten ändern, stehlen oder löschen kann.
  • Prüfen Sie alle Aktionen. Prüfen Sie immer sorgfältig die Aktionen, die Ihr KI-Client in Ihrem Namen ausführt, um sicherzustellen, dass sie korrekt sind und Ihren Absichten entsprechen.