Connect Gmail#
Keep a working native login, or save the keys below.
godmode setup gmailAccount access#
The mailbox address and app password support IMAP/SMTP clients where Google Account policy allows them. App passwords require 2-Step Verification and can be unavailable for some organization accounts, security-key-only setups or Advanced Protection. They do not grant Gmail API, Google SSO or Workspace administration access.
Add credentials#
Save only the keys your product needs.
Mailbox address#
Choose the mailbox your agent will use.
Save as GMAIL_USER in Godmode.
App password#
Let a supported mail client sign in to that mailbox over IMAP or SMTP.
- Type a name under App name, then select Create.
- Copy the 16-character password.
This page works only with 2-Step Verification turned on.
Save as GMAIL_APP_PASSWORD in Godmode.
The password prompt removes spaces, including nonbreaking spaces. With --stdin, remove those spaces yourself.
Check access#
- Configure the mail client with GMAIL_USER and GMAIL_APP_PASSWORD and establish an authenticated TLS IMAP or SMTP session without sending a message. Confirm the mailbox before reading mail or carrying out an authorized send. Use the Gmail API's separate OAuth flow if the task requires that API.
Restore access#
- Google revokes app passwords after an account password change. Create a replacement and save it with godmode set GMAIL_APP_PASSWORD. If app passwords are unavailable, use a supported Google sign-in/OAuth client; repeating app-password setup cannot override account policy.
Provider docs#
Source: Godmode v0.20.0 provider catalog · 2026-11-13.