1. Zugriff auf die Google Cloud Console über den Browser;
2. Neues Projekt mit aussagekräftigem Namen erstellen (z. B. "gcalendar agent");
3. Nach Abschluss der Initialisierung zum neu erstellten Projekt wechseln.

0. Falls erforderlich, auf "Zustimmungsbildschirm konfigurieren" klicken;
1. Anwendungsname eingeben (z. B. "calendar mcp");
2. Autorisierte E-Mail-Adresse angeben;
3. "Externe Zielgruppe" für Benutzertyp-Beschränkungen auswählen;
4. Kontaktinformationen mit derselben E-Mail-Adresse angeben;
5. Anforderungen der Nutzerdatenrichtlinie akzeptieren.

1. Navigieren zu APIs und Dienste → Bibliothek;
2. Nach "Calendar API" suchen;
3. Erstes Ergebnis auswählen und API-Zugriff aktivieren;
4. Überprüfen, ob der API-Status als "Aktiviert" angezeigt wird.

1. Zugriff auf den Bereich Anmeldedaten in APIs und Dienste;
2. OAuth-Client-ID erstellen;
3. "Desktop-Anwendung" als Anwendungstyp auswählen;
4. Generierte JSON-Anmeldedatei herunterladen;
5. Datei vorübergehend auf dem Desktop für einfachen Zugriff speichern (optional).

In Claude den folgenden Prompt kopieren und einfügen:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude erstellt automatisch den Ordner projects, klont das Repository und verschiebt die JSON-Anmeldedatei in das Repository.

• Öffnen Sie Ihren Documents-Ordner;
• Prüfen Sie, ob ein neuer projects-Ordner vorhanden ist;
• Im geklonten Repository finden Sie den neuen Ordner (z. B. google-calendar-mcp). Die Datei gcp-oauth.keys.json befindet sich im Repository.

Führen Sie den nächsten Prompt in Claude aus:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Öffnen Sie Einstellungen → Shortcut: Cmd + , auf Mac oder Ctrl + , auf Windows;
• Wechseln Sie zum Entwickler-Tab → klicken Sie auf Konfiguration bearbeiten;
• Öffnen Sie die Datei claude_desktop_config.json mit einem Texteditor. Die JSON-Datei sollte nun den neuen Konfigurationsblock mit dem korrekten Pfad zur Anmeldedatei anzeigen;
• Wenn korrekt, schließen Sie das Konfigurationsfenster.

• Beenden Sie Claude vollständig (Mac: Cmd + Q, Windows: Alt + F4);
• Starten Sie die App neu;
• Nach dem Start werden Sie auf eine Google-Authentifizierungsseite weitergeleitet:
  • Wählen Sie das gleiche Google-Konto wie für das Projekt verwendet;
  • Wenn Sie dazu aufgefordert werden, klicken Sie auf Zulassen, um Zugriff zu gewähren;
  • Sobald die Authentifizierung erfolgreich ist, schließen Sie den Tab.

Im Terminal (Mac) oder in der Eingabeaufforderung (Windows) starten Sie im Standardfall im Stammverzeichnis und navigieren zu dem Ordner, in dem Sie alle zukünftigen AI-Agent-Verzeichnisse speichern möchten.

• Um auf einen Ordner zuzugreifen, verwenden Sie den Befehl cd folder_name, zum Beispiel:

cd Documents

Um einen neuen Ordner zu erstellen, verwenden Sie den Befehl mkdir new_folder_name, zum Beispiel:

mkdir projects

Und navigieren Sie mit dem Befehl cd command in diesen neuen Ordner:

cd projects

Verwenden Sie den Befehl git clone link, um das GitHub-Repository zu klonen:

git clone https://github.com/nspady/google-calendar-mcp.git

Wechseln Sie mit dem Befehl cd in das neu erstellte Repository:

cd google-calendar-mcp

Nun muss die Datei mit den Zugangsdaten in den Ordner mit dem KI-Agenten (google_calendar_mcp) verschoben werden. Dies kann manuell erfolgen, indem Sie das Dateisymbol in den geöffneten Ordner im Dateiexplorer ziehen. Oder Sie verwenden das Terminal/die Kommandozeile und kopieren die Datei mit dem Befehl cp path/to/file_name ., zum Beispiel:

cp ~/Desktop/gsp-oauth.keys.json .

Der Punkt (.) am Ende gibt das aktuelle Verzeichnis als Ziel an.

Sie können überprüfen, ob die JSON-Datei erfolgreich in den Ordner verschoben wurde, indem Sie im Terminal den Befehl ls ausführen und den Dateinamen in der Liste suchen.

Nach dem Verschieben der Datei löschen Sie diese am ursprünglichen Speicherort (z. B. Desktop).

Im Terminal/in der Kommandozeile verwenden Sie

npm install

Dieser Befehl lädt alle erforderlichen Pakete und Abhängigkeiten herunter.

Arbeiten Sie weiter im Terminal/in der Kommandozeile und führen Sie aus:

npm start

Dieser Befehl startet das im Projekt in der Datei package.json definierte Standard-Startskript, welches typischerweise die Anwendung oder den Server startet; in unserem Fall wird der Authentifizierungsprozess gestartet.

1. Browserfenster öffnet sich automatisch;
2. Passendes Google-Konto auswählen;
3. Kalenderzugriffsrechte gewähren;
4. Meldung "Authentifizierung erfolgreich" bestätigen;
5. Browserfenster schließen.

Claude Desktop Integration

• Konfigurationsblock kopieren:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Claude-Konfigurationsdatei öffnen über Command/Ctrl + , → "Entwickler" → "Konfiguration bearbeiten";
• Konfigurationsdatei claude_desktop_config.json mit Texteditor öffnen;
• Neue Konfiguration als nächsten Block nach bestehenden Konfigurationen und vor den beiden letzten schließenden geschweiften Klammern hinzufügen;
• Auf korrekte JSON-Syntax mit richtiger Klammerung und Kommas nach jedem Konfigurationsblock (außer dem letzten) achten.

Im Terminal/in der Kommandozeile ausführen:

pwd

Den vollständigen Verzeichnispfad kopieren und vor "/build" in der Konfigurationsdatei einfügen.

Konfigurationsdatei speichern mit Command/Ctrl + S.

1. Claude Desktop vollständig neu starten;
2. Überprüfen, ob der neue Server in den verfügbaren Tools erscheint.