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 enabled; it's off by default on some accounts.

Confirm this before touching anything in Thunderbird, since it's the single most common reason a first connection attempt fails outright. If you manage a Google Workspace account instead of a personal Gmail address, your organization's admin may also need to allow IMAP access at the domain level before your own toggle has any effect.

Open Thunderbird and use the built-in account setup wizard instead of entering server details by hand on the first attempt. Enter your name, your full Gmail address, and let Thunderbird auto-detect the correct IMAP and SMTP settings; it recognizes Gmail's servers in most cases.

If auto-detection doesn't complete, or you want to check its work, go to Account Settings > Server Settings and confirm the incoming server is imap.gmail.com on port 993 with SSL/TLS, and the outgoing server is smtp.gmail.com on port 587 with STARTTLS or port 465 with SSL/TLS. A mismatch between the port and the encryption setting is the most common cause of a connection that times out.

When Thunderbird asks you to sign in, it opens a Google sign-in window, not a password field inside Thunderbird itself. This isn't optional for most accounts: Google discontinued plain username-and-password sign-in for third-party mail apps in 2022, so typing your normal Gmail password when prompted will be rejected regardless of whether two-factor authentication is turned on.

Complete the sign-in popup and grant Thunderbird the permissions it requests. An app password generated from your Google Account's security settings, which requires 2-Step Verification to be on, is the fallback for setups that need basic authentication instead. 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 suddenly broke.

Once connected, Thunderbird starts pulling down your existing Gmail folders, labels and messages. Depending on the size of your mailbox, this first sync can take anywhere from a couple of minutes to over an hour. Avoid creating folders or moving messages around in either Gmail or Thunderbird while it's 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 these are showing up where expected, not as duplicate or oddly nested folders. If a label isn't appearing, go back to Gmail's Settings, open 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: recheck that IMAP is still enabled in Gmail, since it can get toggled off during a security review; re-authenticate through Google's sign-in if your session expired; or right-click the account in Thunderbird and choose Subscribe to confirm every folder you want is selected for syncing, not hidden.