node cookbook
N8N Gmail Node Cookbook
Use the Gmail node for email workflows such as sending messages, processing inbox events, labeling messages, or building lightweight notification automations.
Independent third-party notes. n8n is a trademark of its owner and is referenced only for compatibility and troubleshooting context.
Quick Answer
Use the Gmail node for email workflows such as sending messages, processing inbox events, labeling messages, or building lightweight notification automations.
Key Facts
- Credential type
- Google OAuth credentials for Gmail access.
- Common uses
- Send email, search messages, manage labels, and route inbound communication.
- Best fit
- Notifications, support triage, digest emails, and CRM handoffs.
- Common companion nodes
- Schedule Trigger, IF, OpenAI, Google Sheets, and Slack.
Recommended Steps
- Configure Gmail credentials with the required scopes.
- Select the Gmail operation, such as send or search.
- Map recipients, subject, body, labels, or query fields.
- Test with a low-risk mailbox or test label.
- Add error handling for authentication and quota-related failures.
Verification
- The node authenticates to the expected mailbox.
- A test message or query returns the expected result.
- The workflow handles empty inbox/search results cleanly.
Warnings
- Email automations can send real messages quickly; test with safe recipients first.
- Gmail API access and scopes should be limited to the workflow's real need.