Connect Gmail / Google Workspace

Before you start

Open the Add mailbox dialog in AI Emaily. You will see three tabs: Gmail, Outlook, and IMAP. Gmail is the right choice for both personal Gmail and Google Workspace accounts.

If you use the IMAP path instead of Google sign-in, you need a Google app password, not your normal Google login password. App passwords require 2-Step Verification to be turned on.

Connect with Google sign-in (recommended)

1. 1

   Open the Gmail tab

   In the Add mailbox dialog, select the Gmail tab.

2. 2

   Start Google sign-in

   Click Connect with Google. A Google window opens.

3. 3

   Choose your account

   Pick the Gmail or Google Workspace account you want to add, then sign in if prompted.

4. 4

   Grant access

   Review the requested permissions and approve them so AI Emaily can read and send mail for that account.

5. 5

   Finish

   Google returns you to AI Emaily. The mailbox appears and the first sync begins automatically. No host, port, or password entry is needed with this path.

Create an app password

Use this path only if you prefer not to use Google sign-in. The app password lets AI Emaily connect over IMAP.

1. 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. 2

   Open the app passwords page

   Visit myaccount.google.com/apppasswords and sign in if asked.

3. 3

   Generate a password

   Create a new app password and give it a name such as AI Emaily. Google shows a 16-character password.

4. 4

   Copy the password

   Copy the 16-character value. You will paste it into AI Emaily next. You will not be able to see it again after you close the page.

5. 5

   Enable IMAP in Gmail

   In Gmail, go to Settings, then Forwarding and POP/IMAP, and turn on Enable IMAP. On Google Workspace, an admin must allow IMAP for your account first.

Add it to AI Emaily (IMAP tab)

1. 1

   Open the IMAP tab

   In the Add mailbox dialog, select the IMAP tab.

2. 2

   Enter your email address

   Type your full Gmail or Google Workspace address.

3. 3

   Paste the app password

   Paste the 16-character app password into the password field. Do not use your normal Google login password.

4. 4

   Confirm server settings

   Use the values in the Server settings table below for the IMAP and SMTP hosts and ports if they are not filled in for you.

5. 5

   Save

   Save the mailbox. AI Emaily verifies the connection before saving. If the test fails, a hint indicates which setting is likely wrong.

Server settings

Troubleshooting

• 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 in your Google Account security settings, then generate the app password at myaccount.google.com/apppasswords.
• Login works but no mail syncs: IMAP is not enabled. In Gmail, go to Settings, then Forwarding and POP/IMAP, and turn on Enable IMAP.
• Google Workspace account cannot connect over IMAP: an admin must allow IMAP for your organization or account.
• Connection refused or timed out: check the host and port and TLS mode. Use imap.gmail.com on port 993 (SSL) for receiving, and smtp.gmail.com on port 465 (SSL) or 587 (STARTTLS) for sending.
• Still failing: re-read the hint shown when the connection test fails, since it points to the setting that is most likely wrong.