1. Navigieren zu Google Cloud Console;
2. Neues Projekt erstellen oder ein bestehendes auswählen;
3. Projektnamen eingeben (z. B. "gmail mcp agent");
4. Vorgeschlagene Organisations- und Standort-Einstellungen übernehmen;
5. Auf Erstellen klicken und auf die Initialisierung des Projekts warten.

1. Im Seitenmenü zu "APIs & Dienste" → "Bibliothek" wechseln;
2. Nach "Gmail API" suchen;
3. Erstes Ergebnis auswählen und auf "Aktivieren" klicken;
4. Dadurch erhält das Projekt die Berechtigung, auf Gmail-Funktionen zuzugreifen.

1. Zum Tab "Anmeldedaten" navigieren;
2. Falls erforderlich, auf "Zustimmungsbildschirm konfigurieren" klicken;
3. Auf "Erste Schritte" klicken;
4. Anwendungsnamen eingeben (z. B. "gmail agent");
5. E-Mail-Adresse angeben;
6. "Externe Zielgruppe" als Nutzertyp auswählen, falls ein allgemeines Gmail-Konto verwendet wird;
7. E-Mail-Adresse erneut eingeben, wenn dazu aufgefordert;
8. Datenschutzrichtlinie für Nutzerdaten akzeptieren;
9. Auf Weiter und Erstellen klicken.

1. Auf "OAuth-Client erstellen" klicken;
2. "Webanwendung" auswählen;
3. Vorgeschlagenen Namen übernehmen oder anpassen;
4. Auf "URI hinzufügen" klicken;
5. Die Redirect-URI eingeben: http://localhost:3000/oauth2callback;
6. Auf den blauen Erstellen-Button klicken;
7. Die JSON-Anmeldedatei herunterladen;
8. Datei umbenennen in: gsp-oauth.keys.json.

Zum Stamm-/Home-Verzeichnis navigieren:

• Mac: Home-Ordner Users/user_name oder Windows: C:\Users\Your_Username\;
• Mit Command + Shift + . (Mac) oder Ctrl + Shift + . (Windows) versteckte Dateien anzeigen;
• Einen neuen Ordner mit dem Namen: .gmail-mcp erstellen;
• Die Datei gsp-oauth.keys.json in diesen Ordner verschieben;
• Mit Command + Shift + . erneut die Ordner ausblenden.

Der Server ist so konfiguriert, dass er die Anmeldedaten automatisch in diesem Verzeichnis findet.

• Öffnen von Claude mit installiertem Desktop Commander MCP. Für eine schnelle Einrichtung den Smithery-Befehl verwenden;
• In einem neuen Claude-Chat den folgenden Prompt eingeben:

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• Während der Ausführung fragt Claude nach der Berechtigung zur Nutzung von Desktop Commander MCP. Immer erlauben oder Einmal erlauben auswählen;
• Es erfolgt eine Weiterleitung zur Google Auth-Seite. Die gleiche E-Mail-Adresse wie für das Cloud-Projekt auswählen. Zulassen anklicken, um den Zugriff auf Gmail zu gewähren. Auf die Erfolgsmeldung warten;
• Claude Desktop neu starten. Der neue Server sollte nun als verbunden angezeigt werden.

• Den Prompt kopieren und in einen neuen oder bereits geöffneten Claude-Chat einfügen:

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Den Prompt ausführen → Claude aktualisiert die Konfigurationsdatei.
• Überprüfen, ob der Block korrekt hinzugefügt wurde (optional). Zu Einstellungen gehen (Tastenkürzel: Cmd + ,) → Entwickler → Konfiguration bearbeiten → Datei claude_desktop_config.json im Texteditor öffnen;
• Claude Desktop vollständig schließen und erneut öffnen.

Konfigurationsdatei aktualisieren

• In Claude Desktop Command + , (Mac) oder Ctrl + , (Windows) drücken;
• Auf "Konfiguration bearbeiten" klicken;
• Die Konfigurationsdatei im Texteditor öffnen;
• Den Konfigurationsblock kopieren;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• In die Claude-Konfigurationsdatei nach dem vorherigen Konfigurationsblock und vor den letzten beiden geschweiften Klammern einfügen;
• Datei speichern (Command/Ctrl + S);
• Claude Desktop vollständig schließen und erneut öffnen.