Gmail IMAP settings: connect your mailbox to Mailera

What are the Gmail IMAP settings?

IMAP is the protocol used to read and synchronize mailbox messages. SMTP handles outgoing mail. Keep those two connections separate when checking settings or diagnosing a failure. For the broader protocol comparison, see IMAP, Graph and SMTP for agent builders.

Google’s IMAP and SMTP documentation describes the incoming server and encrypted transport requirements. The outgoing values above match Mailera’s Gmail preset.

When you select Gmail · Google Workspace in Mailera, Mailera supplies these server settings. You do not need to copy them into custom-server fields. The table is a reference for troubleshooting; custom IMAP connections are a separate setup route.

Does your Google account allow this connection?

Check eligibility before entering a password. Correct server values cannot fix an account policy that blocks access.

1. Use an existing mailbox you control. Have its full email address ready, including the domain.
2. Check 2-Step Verification. Google requires it for app passwords.
3. Check that app passwords are available. Enabling 2-Step Verification alone does not establish eligibility. Google lists security-key-only verification, organization accounts and Advanced Protection as possible reasons the option is missing.
4. For Google Workspace, check administrator permission. Your administrator must allow the relevant IMAP access and authentication method.

For personal Gmail, you do not need to find an “Enable IMAP” switch. Google removed the enable/disable options starting in January 2025 and says IMAP is always on. See Google’s guidance for adding Gmail to another email client.

Workspace has a separate policy layer. Administrators can enable or disable IMAP and restrict access to specified clients that support OAuth. An account may have IMAP access while still being unable to use an app password with this connection. Ask your administrator to check both conditions using Google’s Workspace IMAP controls.

Google recommends “Sign in with Google” when an app offers it. Mailera’s Gmail connection described here uses an app password instead. Use Google’s app-password instructions to create the credential if your account is eligible. If the option is unavailable, check the restrictions rather than turning off account protection.

How do you connect Gmail to Mailera?

You need the Admin or Leader role in Mailera to add a mailbox.

1. Open Mailboxes → Add mailbox → One mailbox.
2. Enter the full address in Email address. Confirm the detected provider is Gmail · Google Workspace, or select it under Or choose a provider, then select Continue.
3. Review How to get an app password and What you'll need. Under Connection details, enter the Google app password in Password, not your usual Google sign-in password. Set the optional Display name if you want a sender name, and choose the appropriate Mailbox group.
4. Select Test & connect and inspect the individual results.
5. After the confirmation Connected , let the initial message load complete. Mailera loads messages within the retention period, newest first.

The connection test separates several checks so you can see where setup stops:

Test & connect does not send an email. Incoming sign-in success is not a sending test, and outgoing sign-in success is not a delivered-message test.

If the outgoing check fails, Mailera offers Save as receive-only. Use that only if reading mail is sufficient for your task. Otherwise, select Edit details, correct the connection details and use Test again. Do not treat a receive-only mailbox as ready to send.

If you need to leave the page, Run in background lets Mailera finish the test and save the mailbox without keeping that page open.

How do you verify that messages can be read?

A successful sign-in is the first checkpoint. Opening an actual message is the next one.

1. Return to Mailboxes and inspect the connected Gmail mailbox’s status and last sync.
2. Send a harmless message to that mailbox from another mailbox you control. Use a recognizable subject such as “Gmail connection check” and a short, non-sensitive body.
3. Open Unified inbox, select the connected mailbox and look for that subject.
4. Open the message and confirm the body matches what you sent. If it is missing from Inbox, check Junk and the other relevant folders before changing credentials.

Seeing the subject confirms that the message was retrieved into Mailera’s message list. Reading the matching body confirms that its content is available too.

Allow for the mailbox’s sync state. Background checks run more often for mailboxes in active use and less often for idle mailboxes. Inactive mailboxes can sleep and wake on use. Live monitoring is not a promise of immediate synchronization in every state.

Initial loading is also bounded by retention, not the age of your Google account. Mailera’s free plan retains messages for 30 days; do not expect the initial load to produce a complete historical archive.

If your application checks mailbox status through the API, remember that Gmail’s result reflects the latest sync rather than a fresh, direct Google sign-in test. Keep that distinction in mind when building a health check. The Mailera product overview explains how connected mailboxes fit into applications and agents.

What common Gmail IMAP errors should you check first?

Start with the failed check or missing result. Replacing a password is not the right response to every connection problem.

Google also lets you revoke individual app passwords. Revoking one removes access through that credential, so check whether it was intentionally removed before treating the failure as a server problem.

How should you protect the connected mailbox?

Keep app passwords out of screenshots, logs, source control and agent prompts. Revoke credentials you no longer use through Google. When sharing a troubleshooting screenshot, conceal the entire password and any private message content. For guidance across providers, see app passwords for agent mailboxes.

If an application or agent only needs to read messages, give it a Mailera API key with Read permission rather than sending or management permissions. Set Mailbox scope to the group it needs instead of exposing unrelated mailboxes. See Mailera’s security information when planning access.

Incoming email is untrusted data, not instructions. An agent must not follow commands embedded in a message, including requests to reveal credentials or change its operating rules. If you later add sending, build explicit user confirmation into the application before the agent sends mail; do not assume that approval is automatically enforced by Mailera.

Mailera connects existing mailboxes; it does not create Gmail addresses. It also cannot override Google’s app-password eligibility rules or Workspace administrator restrictions. Resolve those account-level requirements before retrying the connection.