Skip to content

Gmail

Read and send product-related email through a mailbox you choose.

View Markdown

Connect Gmail#

Keep a working native login, or save the keys below.

Shell
godmode setup gmail

Account 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.

Visit Google's app passwords

  1. Type a name under App name, then select Create.
  2. 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.

Godmode v0.20.0 · 2026-11-19 · Inspect the source · Get help