Inhaltsverzeichnis
- Einleitung: Warum Google OAuth2 für n8n so wichtig ist
- Schritt-für-Schritt-Anleitung: Google OAuth2 für Gmail, Drive & Sheets in n8n einrichten
- Fazit & Praxistipps
Einleitung: Warum Google OAuth2 für n8n so wichtig ist
Wenn du n8n mit Google-Diensten wie Gmail, Google Drive und Google Sheets verbinden möchtest, führt kein Weg an Google OAuth2 vorbei. OAuth2 ist das Authentifizierungs- und Autorisierungssystem von Google und sorgt dafür, dass n8n kontrollierten Zugriff auf dein Google-Konto erhält – ohne dass du Passwörter direkt in n8n speichern musst.
In diesem Leitfaden setzen wir gemeinsam eine komplette OAuth2-Verbindung auf. Ziel ist, dass du am Ende in n8n ein einziges Google-Credential hast, mit dem du:
- E-Mails über die Gmail API lesen, erstellen und versenden kannst,
- Dateien in der Google Drive API lesen, hochladen und organisieren kannst,
- Daten in Google Sheets (Tabellen) lesen, schreiben und aktualisieren kannst.
Die Anleitung orientiert sich an der praktischen Vorgehensweise: von der Google Cloud Console über das Einrichten der OAuth-Zustimmungsseite bis hin zum finalen Verbindungsaufbau in n8n – inklusive eines Hinweises auf typische Stolperfallen (Testmodus, Scopes, Redirect-URL etc.).
Schritt-für-Schritt-Anleitung: Google OAuth2 für Gmail, Drive & Sheets in n8n einrichten
1. Überblick: Was wir konfigurieren
Damit n8n sich bei Google authentifizieren darf, brauchst du drei Bausteine:
- Ein Google Cloud Projekt, in dem du die benötigten APIs aktivierst.
- Eine OAuth-Zustimmungsseite (OAuth Consent Screen), über die Google dir anzeigt, welche Rechte n8n erhält.
- OAuth2-Credentials (Client ID & Client Secret), die du in n8n hinterlegst.
All das erledigst du einmalig in der Google Cloud Console. Danach kannst du dasselbe Credential in n8n immer wieder verwenden, solange du denselben Google-Account bzw. dasselbe Projekt nutzt.
2. In n8n: Neues Google-OAuth2-Credential anlegen
Beginnen wir in n8n, damit du direkt die nötige Redirect-URL zur Hand hast:
- Öffne n8n und gehe in den Bereich Credentials (Zugangsdaten).
- Erstelle ein neues Credential und wähle z. B. Gmail OAuth2 API (oder das entsprechende Google OAuth2-Credential) aus.
-
In der Konfiguration siehst du u. a.:
- Redirect URL (Authorized Redirect URI) – diese brauchst du gleich in der Google Cloud Console.
- Felder für Client ID und Client Secret – diese kommen von Google.
- Nutze die Funktion „Click to Copy“ an der Redirect-URL und kopiere dir diesen Wert in die Zwischenablage. Den fügen wir später in der Google Cloud als Authorized Redirect URI ein.
3. In der Google Cloud Console: Projekt anlegen oder auswählen
Nun wechseln wir zu Google:
- Öffne https://console.cloud.google.com und melde dich mit dem Google-Account an, den du mit n8n verbinden möchtest.
-
Oben in der Projekt-Auswahl kannst du entweder ein bestehendes Projekt wählen oder ein neues anlegen:
- Klicke auf „New Project“ / „Neues Projekt“.
- Gib einen Namen ein, z. B. n8n Test.
- Optional: Ordne das Projekt einer Organisation zu, falls vorhanden. Für Test-Setups und viele Umgebungen ist das zunächst nicht kritisch – es geht häufig um Billing-/Abrechnungsstrukturen.
- Klicke auf Create und warte kurz, bis das Projekt erstellt ist.
- Wähle anschließend dein neues Projekt (z. B. n8n Test) oben in der Projektliste aktiv aus.
4. Benötigte Google APIs aktivieren (Gmail, Drive, Sheets)
Damit n8n mit Gmail, Drive und Sheets sprechen darf, müssen die jeweiligen APIs in deinem Projekt aktiviert werden:
- Navigiere in der Google Cloud Console zu „APIs & Services“ → „Library“ (oder „API-Bibliothek“).
-
Suche nacheinander nach folgenden APIs und aktiviere sie:
- Gmail API – auswählen und auf Enable / „Aktivieren“ klicken.
- Google Drive API – achte darauf, nicht die Drive Labels API zu erwischen.
- Google Sheets API (Google Tabellen).
- Nach jedem Klick auf Enable kurz warten, bis die Aktivierung durchgelaufen ist, und dann zur Library zurückkehren, um die nächste API zu aktivieren.
5. OAuth-Zustimmungsbildschirm (OAuth Consent Screen) einrichten
Jetzt definierst du, wie Google die Verbindung zu n8n darstellt und welche Nutzer die App im Testmodus verwenden dürfen.
- Gehe in der Google Cloud Console zu „APIs & Services“ → „OAuth consent screen“.
- Wähle den User-Typ (in vielen Fällen reicht für den Start „Internal“ bei Organisationen bzw. „External“ für normale Konten; orientiere dich an deiner bestehenden Konfiguration).
-
Trage die Basisdaten ein:
- App name – z. B. n8n Google Integration oder n8n Test.
- User support email / Kontakt-E-Mail-Adresse – die E-Mail, mit der du angemeldet bist bzw. unter der du erreichbar bist.
- Optional: Logos, Domain-Angaben etc. kannst du für einen Test zunächst weglassen oder später ergänzen.
- Stimme den Nutzungsbedingungen bzw. Hinweisen zu und klicke auf Create / „Erstellen“.
5.1 Testnutzer (Test Users) hinterlegen – ganz wichtig im Testmodus
Standardmäßig befindet sich deine App nach dem Anlegen im Testmodus. In diesem Modus können nur explizit eingetragene Test User die App nutzen.
- Im Bereich des OAuth Consent Screens findest du eine Sektion „Test users“ oder „Testnutzer“.
- Füge dort den Google-Account als Testnutzer hinzu, mit dem du die Verbindung zu n8n aufbauen möchtest (meist dein aktuell angemeldetes Konto).
- Speichere die Konfiguration.
Ohne diesen Eintrag als Test User können deine Google-Dienste im Testmodus nicht genutzt werden – die Verbindung schlägt dann später fehl.
6. OAuth2-Client (Client ID & Client Secret) anlegen
Jetzt erzeugen wir die eigentlichen Zugangsdaten, die n8n verwenden soll.
- Gehe in der Google Cloud Console zu „APIs & Services“ → „Credentials“.
- Klicke auf „Create credentials“ und wähle „OAuth client ID“.
- Wähle als Anwendungstyp „Web application“ (Webanwendung).
- Vergib einen aussagekräftigen Namen, z. B. n8n Test, damit du den Client später gut wiedererkennst.
- Bei Authorized JavaScript origins musst du für die n8n-Integration normalerweise nichts eintragen.
-
Ganz wichtig ist der Bereich Authorized redirect URIs:
- Klicke auf „Add URI“ / „URI hinzufügen“.
- Füge hier die Redirect-URL ein, die du zuvor aus n8n kopiert hast (Click to Copy).
- Klicke auf Create / „Erstellen“.
Google zeigt dir nun ein Fenster mit deinen Zugangsdaten:
- Client ID
- Client Secret
Lass dieses Fenster geöffnet oder kopiere dir die Werte sicher weg – sie werden gleich in n8n benötigt.
7. Client ID & Client Secret in n8n eintragen
Wechsle nun zurück zu n8n zu deinem noch offenen Google-/Gmail-OAuth2-Credential.
- Trage die von Google erhaltene Client ID in das entsprechende Feld in n8n ein.
- Trage das Client Secret in das zugehörige Feld ein.
- Speichere das Credential (sofern ein „Save“-Button vorhanden ist) oder fahre direkt mit der Authentifizierung fort.
8. „Sign in with Google“ aus n8n heraus durchführen
Sobald Client ID und Client Secret korrekt hinterlegt sind, sollte in n8n ein Button wie „Sign in with Google“ erscheinen.
- Klicke auf „Sign in with Google“.
- Es öffnet sich ein Google-Anmeldefenster. Wähle den Google-Account aus, den du als Test User hinterlegt hast.
- Du siehst vermutlich einen Hinweis, dass es sich um eine nicht verifizierte Test-App handelt und dass du dich im Testmodus befindest.
- Klicke hier nicht auf „Back to safety“ / „Zurück zur Sicherheit“, sondern auf „Weiter“ / „Continue“, um fortzufahren. Du bestätigst damit, dass du diese Test-App selbst bewusst verwendest.
8.1 Scopes auswählen und bestätigen
Im nächsten Schritt zeigt dir Google die sogenannten Scopes an. Das sind die Berechtigungen, die n8n für dein Konto anfordert. Für die Kombination aus Gmail, Drive und Sheets können u. a. folgende Scopes erscheinen:
- E-Mails lesen (Gmail-Nachrichten anzeigen und lesen)
- Entwürfe verwalten
- E-Mails erstellen und senden
- Dateien auf Google Drive anzeigen, bearbeiten oder erstellen
- Tabellen in Google Sheets lesen und bearbeiten
Wähle alle Scopes aus, die du nutzen möchtest (für die meisten Automationen rund um Gmail/Drive/Sheets bietet es sich an, alle vorgeschlagenen Scopes für diese Dienste zu aktivieren), und klicke auf „Continue“ / „Weiter“.
Nach der Bestätigung leitet dich Google zurück zu n8n – genau über die zuvor definierte Redirect-URL.
9. Verbindung in n8n prüfen und Credential sinnvoll benennen
Zurück in n8n solltest du nun sehen, dass dein Credential erfolgreich verbunden ist:
- Der Status wird als „Connected“ angezeigt.
- Häufig erscheint ein grüner Hintergrund oder ein ähnlicher visueller Hinweis für eine erfolgreiche Verbindung.
Empfehlung zur Benennung:
-
Benenne das Credential nicht nur nach „Gmail“, sondern so, dass ersichtlich ist, dass es für dein gesamtes Google-Konto genutzt wird. Ein Beispiel:
- „Google – Gmail, Drive & Sheets – <dein.konto@beispiel.com>“
-
Das ist besonders hilfreich, wenn du:
- mit mehreren Google-Accounts arbeitest (privat, geschäftlich, Test usw.), oder
- in einem Team arbeitest und mehrere Personen n8n-Credentials verwenden.
Mit einer klaren Benennung ersparst du dir später viel Zeit, weil du nicht erneut in die Google Cloud Console springen musst, um herauszufinden, welche Client ID zu welchem Konto gehört.
Fazit & Praxistipps
Mit der hier beschriebenen Schritt-für-Schritt-Konfiguration hast du Google OAuth2 in n8n so eingerichtet, dass du Gmail, Google Drive und Google Sheets sicher und kontrolliert nutzen kannst. Die wichtigsten Punkte im Überblick:
- Redirect-URL aus n8n unbedingt exakt als Authorized Redirect URI in der Google Cloud hinterlegen.
- APIs aktivieren: Gmail API, Google Drive API, Google Sheets API müssen im gewählten Projekt eingeschaltet sein.
- OAuth Consent Screen sauber ausfüllen und im Testmodus zwingend Test User hinterlegen.
- Client ID & Client Secret aus der Google Cloud in n8n eintragen und dann über „Sign in with Google“ den OAuth-Flow durchlaufen.
- Scopes bewusst auswählen – je nach dem, was dein Workflow in n8n braucht.
- Credential aussagekräftig benennen, insbesondere bei mehreren Google-Accounts oder Team-Nutzung.
Sobald das Credential „Connected“ ist, kannst du es in deinen n8n-Workflows nutzen – nicht nur für Gmail, sondern auch für Drive- und Sheets-Nodes. Damit steht dir ein leistungsfähiges Setup für automatisierte E-Mail-Prozesse, Datei-Workflows und datengetriebene Automationen mit Google Sheets zur Verfügung.
Wenn du später weitere Google-Dienste integrieren möchtest, kannst du meist dasselbe OAuth2-Credential wiederverwenden, sofern die benötigten Scopes und APIs im Projekt aktiviert sind. So baust du Schritt für Schritt eine zentrale, saubere Google-Integration in n8n auf.