> Godmode v0.19.2 documentation · Reviewed 2026-11-17
> Source: https://godmode.build/docs/v0.19.2/provider-gmail

# Gmail

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

## Connect Gmail

Keep a working [native login](/docs/v0.19.2/credentials#keep-a-working-login), or save the keys below.

```sh
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](https://myaccount.google.com/apppasswords)**

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

- [App passwords and recovery](https://support.google.com/accounts/answer/185833)
- [Gmail IMAP and SMTP](https://developers.google.com/workspace/gmail/imap/imap-smtp)

Source: Godmode v0.19.2 provider catalog · 2026-11-13.
