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 Ihr 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. Ihre E-Mail-Adresse eingeben;
6. "Externe Zielgruppe" als Benutzertyp auswählen, wenn Sie ein allgemeines Gmail-Konto verwenden;
7. Bei Aufforderung Ihre E-Mail-Adresse erneut eingeben;
8. Die Nutzerdatenrichtlinie 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. Die 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 Sie Claude mit installiertem Desktop Commander MCP. Für eine schnelle Einrichtung verwenden Sie den Smithery-Befehl;
• Geben Sie in einem neuen Claude-Chat den folgenden Prompt ein:

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. Klicken Sie auf Immer erlauben oder Einmal erlauben;
• Sie werden auf eine Google-Authentifizierungsseite weitergeleitet. Wählen Sie die gleiche E-Mail-Adresse wie für das Cloud-Projekt. Klicken Sie auf Zulassen, um den Zugriff auf Gmail zu gewähren. Warten Sie auf die Erfolgsmeldung;
• Starten Sie Claude Desktop neu. Der neue Server sollte nun als verbunden angezeigt werden.

• Kopieren Sie den Prompt und fügen Sie ihn in einen neuen oder bereits geöffneten Claude-Chat ein:

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

• Führen Sie den Prompt aus → Claude aktualisiert die Konfigurationsdatei.
• Überprüfen Sie optional, ob der Block korrekt hinzugefügt wurde. Gehen Sie zu Einstellungen (Tastenkürzel: Cmd + ,) → Entwickler → Konfiguration bearbeiten → öffnen Sie die Datei claude_desktop_config.json im Texteditor;
• Schließen Sie Claude Desktop vollständig und öffnen Sie es erneut.

Konfigurationsdatei aktualisieren

• Drücken Sie in Claude Desktop Command + , (Mac) oder Ctrl + , (Windows);
• Klicken Sie auf "Konfiguration bearbeiten";
• Öffnen Sie die Konfigurationsdatei im Texteditor;
• Kopieren Sie den Konfigurationsblock;

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

• Fügen Sie ihn nach dem vorherigen Konfigurationsblock und vor den letzten beiden geschweiften Klammern in Ihre Claude-Konfigurationsdatei ein;
• Speichern Sie die Datei (Command/Ctrl + S);
• Schließen Sie Claude Desktop vollständig und öffnen Sie es erneut.