How to Use Gmail With Thunderbird (IMAP Setup Guide) Easily 2026

Before Thunderbird can do anything, Gmail needs to allow IMAP connections at all. In Gmail, open Settings, go to the "Forwarding and POP/IMAP" tab, and make sure IMAP access is set to enabled — it's off by default on some accounts.

This single toggle is the most common reason a Thunderbird connection fails outright, so confirm it before touching anything in Thunderbird itself. If you manage a Google Workspace account rather than a personal Gmail address, your organization's admin may also need to allow IMAP access at the domain level before the toggle in your own settings has any effect.

Open Thunderbird and use the built-in account setup wizard rather than manually entering server details on the first attempt. Enter your name, your full Gmail address, and your password, and let Thunderbird try to auto-detect the correct IMAP settings — it recognizes Gmail's servers in most cases and fills in the configuration for you, which avoids typos in the server address or port number. The wizard will present the detected settings for you to confirm before finishing; take a moment to read them rather than clicking through, since this is the easiest point to catch a wrong setting before it becomes a connection problem later.

If auto-detection doesn't complete or you need to check the settings manually, go to Account Settings > Server Settings in Thunderbird and confirm the incoming server is imap.gmail.com on port 993 with SSL/TLS connection security, and the outgoing (SMTP) server is smtp.gmail.com on port 465 or 587 depending on the encryption method selected. A mismatch on any one of these — wrong port, wrong encryption setting — is the second most common cause of a connection that times out or rejects your password. It's worth writing these values down somewhere before you start, since Thunderbird's error messages when one is wrong tend to be vague, more often reporting a generic connection failure than pointing at the specific field that's misconfigured.

When Thunderbird prompts for authentication, it typically opens a Google sign-in window rather than accepting your Gmail password directly inside the app, especially if you have two-factor authentication enabled. Complete that sign-in and grant Thunderbird the permissions it requests.

If you've previously created an app-specific password for another mail client, that can also work here, but the Google sign-in flow is the more reliable path for most accounts. Keep in mind Google occasionally re-prompts for this authorization months later as a routine security check, which is worth remembering so it doesn't look like Thunderbird has suddenly broken when it's really just asking you to reauthorize.

Once connected, Thunderbird will start pulling down your existing Gmail folders, labels, and messages, and depending on how large your mailbox is, this first sync can take anywhere from a couple of minutes to over an hour. Avoid creating new folders or moving messages around in either Gmail or Thunderbird while this initial sync is running, since changes made mid-sync are more likely to cause duplicated or missing folders afterward.

Gmail's labels appear as folders in Thunderbird, including system ones like Sent, Drafts, and All Mail, so check that these are showing up where you'd expect rather than as duplicate or oddly nested folders. If a label isn't appearing, go back to Gmail's Settings under the Labels tab and make sure "Show in IMAP" is checked for that specific label — labels hidden from IMAP won't sync to Thunderbird at all.

If syncing stalls partway through or new emails stop appearing, the fix is usually one of three things: re-checking that IMAP is still enabled in Gmail (it can get toggled off during a security review), re-authenticating through Google's sign-in if your session expired, or right-clicking the account in Thunderbird and choosing "Subscribe" to make sure all the folders you want are actually selected for syncing rather than hidden.