Google

This section contains:

• OAuth2 single service: Create an OAuth2 credential for a specific service node, such as the Gmail node. Two options exist:

  • Managed OAuth2: Sign in with Google directly on n8n, with no setup required on the Google Cloud Console. Available for n8n Cloud users only, for certain Google nodes.

  • Custom OAuth2: Configure an OAuth2 app in the Google Cloud Console and connect it to your n8n credential.

• OAuth2 API (generic): Create an OAuth2 credential for use with custom operations.

• Service Account: Create a Service Account credential for some specific service nodes.

• Google PaLM and Gemini: Get a Google Gemini/Google PaLM API key.

OAuth2 and Service Account

Google service nodes support two authentication methods:

• OAuth2: Recommended because it's more widely available and easier to set up.

• Service Account: Refer to the Google documentation: Understanding service accounts for guidance on when you need a service account.

Managed OAuth2 for n8n Cloud users

Feature availability

Managed OAuth2 for the Google nodes listed below is available on:

• n8n Cloud: All plans

It isn't available on self-hosted. For self-hosted, configure your own OAuth2 credentials instead.

• Google Calendar

• Google Calendar Trigger

• Google Chat

• Google Contacts

• Google Docs

• Google Drive

• Google Drive Trigger

• Google Mail

• Google Mail Trigger

• Google Sheets

• Google Sheets Trigger

• Google Slides

• Google Tasks

• YouTube

Compatible nodes

Once configured, you can use your credentials to authenticate the following nodes. Most nodes are compatible with OAuth2 authentication. n8n has limited support for Service Account authentication.

Node	OAuth	Service Account
Google Ads	✅	❌
Gmail	✅	⚠️
Google Analytics	✅	❌
Google BigQuery	✅	✅
Google Books	✅	✅
Google Calendar	✅	❌
Google Chat	✅	✅
Google Cloud Storage	✅	✅
Google Contacts	✅	❌
Google Cloud Firestore	✅	✅
Google Cloud Natural Language	✅	❌
Google Cloud Realtime Database	✅	❌
Google Docs	✅	✅
Google Drive	✅	✅
Google Drive Trigger	✅	✅
Google Perspective	✅	❌
Google Sheets	✅	✅
Google Slides	✅	✅
Google Tasks	✅	❌
Google Translate	✅	✅
Google Workspace Admin	✅	❌
YouTube	✅	❌

Gmail and Service Accounts

Google technically supports Service Accounts for use with Gmail, but it requires enabling domain-wide delegation, which Google discourages, and its behavior can be inconsistent.

n8n recommends using OAuth2 with the Gmail node.