Gmail
Connect your Gmail account to alfred_ via OAuth. We never see your password — Google handles authentication directly.
alfred_ connects to Gmail using Google OAuth. This means Google handles authentication directly — alfred_ never sees your password, and you can revoke access at any time from your Google Account settings.
What permissions does alfred_ request?
When you click Connect Gmail, Google will ask you to grant alfred_ the following:
- Read your email — needed to triage incoming messages and draft replies
- Send email on your behalf — needed to send replies you approve
- Modify message labels — needed to archive noise and apply triage labels
We never share, sell, or use your email content for any purpose other than running your assistant.
How to connect
- Open Settings → Connected Accounts in alfred_
- Click Connect Gmail
- Sign in to your Google account (or pick from accounts already signed in)
- Review the permissions screen and click Continue
- You’ll be redirected back to alfred_ — your inbox starts syncing immediately
The first sync takes 30–60 seconds for the past two weeks of mail. Older mail backfills in the background over the next few minutes.
Connecting multiple Gmail accounts
You can connect any number of Gmail accounts. Repeat the steps above for each — you’ll see them all listed under Connected Accounts and can switch the active inbox from the inbox header.
Revoking access
You can revoke alfred_’s access two ways:
- From alfred_ — Settings → Connected Accounts → click the trash icon next to the account
- From Google — visit myaccount.google.com/permissions and remove alfred_ from the list
Either method immediately stops alfred_ from reading or sending mail on that account.
Troubleshooting
”This app is blocked” or admin approval required
You’re on a Google Workspace account (work or school) where IT has restricted third-party apps. Forward the connection link to your IT admin and ask them to allow alfred_ in the Workspace admin console under Security → API Controls.
Connection succeeded but no mail is showing up
First sync can take 30–60 seconds. If after a minute you still see an empty inbox, hit Refresh in the inbox header. If still empty, check Settings → Connected Accounts to confirm the account shows as Connected (green).
”Token expired” warning
This means Google’s OAuth token rotated and alfred_ couldn’t refresh it automatically — usually because you changed your Google password. Click Reconnect next to the affected account in Settings.