Connect Gmail / Google Workspace
Connect a Gmail or Google Workspace account to AI Emaily with one-click Google sign-in, or over IMAP with an app password.
The Google tab signs you in with Google (OAuth) and connects AI Emaily through the Gmail API without a password. AI Emaily is CASA certified for the Gmail access it uses, so this is the recommended way to connect Gmail and Google Workspace. An IMAP app-password option is still available if you prefer it.
Before you start
Open Settings > Mailboxes and select Connect mailbox. The Connect a mailbox dialog has three tabs: Google, Outlook, and IMAP / SMTP.
For Gmail and Google Workspace, use the Google tab. It signs you in through Google, so you never type a password into AI Emaily. Google Workspace accounts need their administrator to allow third-party app access, which most already do.
One-click sign-in never sees your password
Connect with one click (recommended)
- 1
Open the Google tab
In the Connect a mailbox dialog, select the Google tab.
- 2
Start sign-in
Select Connect with Google. A Google sign-in window opens. If nothing opens, allow pop-ups for AI Emaily.
- 3
Sign in to Google
Choose or enter your Gmail or Google Workspace account and complete sign-in, including any two-step prompt.
- 4
Grant access
Review the permissions and select Continue (or Allow). The window closes and returns you to AI Emaily.
- 5
Let the import run
The dialog shows Importing your mail… and then how many emails were imported. Large mailboxes keep importing in the background after you close it.
What syncs from Gmail
- Mail arrives through the Gmail API. Reading, starring, archiving, trashing and marking spam in AI Emaily are mirrored to Gmail, and reading, starring, archiving and trashing done in Gmail come back to AI Emaily.
- Mail Gmail puts in Spam shows in AI Emaily's Spam folder.
- By default, email follows Gmail's tabs: Primary, Social, Promotions and Updates (Forums goes to Social). Sort with AI can take a second look at Primary. You change this per mailbox in Settings > Mailboxes > Edit mailbox > Sorting and AI.
- Sync folders (off by default) shows your Gmail labels as folders and keeps them in step both ways.
- Send-as aliases set up in Gmail or Google Workspace can be turned on per mailbox (Sync send-as aliases), so you can send and reply from them.
- Calendar events sync with your Google Calendar.
Alternative: connect with an app password (IMAP)
Prefer not to use one-click sign-in, or on a Google Workspace account where an admin blocks third-party apps but allows IMAP? You can connect over IMAP with a 16-character Google app password. App passwords require 2-Step Verification.
Over IMAP, Gmail-specific features such as Gmail tabs, synced Gmail labels as folders and send-as aliases are not available. Use the Google tab to get them.
- 1
Turn on 2-Step Verification
Go to your Google Account security settings and enable 2-Step Verification. App passwords are only available once it is on.
- 2
Open the app passwords page
Visit myaccount.google.com/apppasswords and sign in if asked.
- 3
Generate a password
Create a new app password and name it AI Emaily. Google shows a 16-character password once. Copy it.
- 4
Make sure IMAP is allowed
On Google Workspace, an admin must allow IMAP for your account.
- 5
Add it on the IMAP / SMTP tab
In the Connect a mailbox dialog, select IMAP / SMTP, select the Gmail button (or type your address and the servers fill in), paste the app password, then select Test connection and Connect mailbox.
Paste an app password, not your login password
Server settings (IMAP)
| Setting | Value |
|---|---|
| IMAP host | imap.gmail.com |
| IMAP port | 993 (SSL) |
| SMTP host | smtp.gmail.com |
| SMTP port | 465 (SSL), filled in for you; 587 (STARTTLS) also works |
| Password type | 16-character app password (not your login password) |
Troubleshooting
- Sign-in window won't open: your browser blocked the pop-up. Allow pop-ups for AI Emaily, then select Connect with Google again.
- Google Workspace blocks access: your administrator restricts third-party apps. Ask your admin to allow AI Emaily, or use the IMAP app password option above.
- IMAP authentication failed: you likely pasted your normal login password. Use a 16-character app password instead.
- App password option missing: 2-Step Verification is off. Turn it on, then create the app password at myaccount.google.com/apppasswords.
- Sign-in expired later: if AI Emaily loses access (for example you revoked it in your Google Account), the mailbox shows Sign-in expired and a Reconnect button. Reconnecting also grants any new permissions the app has added.
Frequently asked
Ready to try it?
Start Free Trial