How to Connect Thunderbird to a Consumer Outlook.com Email Account
Question details
The user is trying to connect Mozilla Thunderbird to a consumer Outlook.com email account but is facing connection failures when using Exchange Web Services (EWS).
- Product
- Mozilla Thunderbird, Outlook.com
- Device & OS
- not provided
- Scenario
- Setting up a consumer Outlook.com email account within the Thunderbird email client.
- Observed behavior
- Thunderbird cannot use Exchange Web Services (EWS) to connect to the consumer Outlook.com account, even if it is included with a Microsoft 365 Family subscription, because EWS OAuth is intended for organizational tenants.
Ensure you have your Outlook.com email address and password ready, and verify that IMAP access is enabled in your Outlook.com webmail settings under the 'Sync email' or 'Forwarding and IMAP' section.
Configure Thunderbird using IMAP and SMTP with OAuth2
Since Exchange Web Services (EWS) is not supported for consumer Outlook accounts, configuring the account using IMAP and SMTP with modern OAuth2 authentication is the recommended method.
EWS OAuth authentication is primarily intended for Exchange Online work or school accounts. Consumer accounts require standard IMAP/SMTP protocols combined with OAuth2 to securely connect third-party clients like Thunderbird.
Log into Outlook.com through your web browser. Click the Settings gear icon, navigate to Mail > Forwarding and IMAP (or Sync email), and ensure that 'Let devices and apps use POP/IMAP' is enabled.
Open Mozilla Thunderbird. Click on the Application Menu (three horizontal lines), select 'Account Settings', and click 'Account Actions' at the bottom left to choose 'Add Mail Account'.
Type your name, Outlook.com email address, and password. Instead of clicking Continue immediately, click on the 'Configure manually' button to input the specific server settings.
Under the Incoming server section, set the Protocol to IMAP. Enter the Hostname as 'outlook.office365.com', set the Port to '993', choose 'SSL/TLS' for Connection Security, and set the Authentication Method to 'OAuth2'.
Under the Outgoing server section, set the Hostname to 'smtp-mail.outlook.com', set the Port to '587', choose 'STARTTLS' for Connection Security, and set the Authentication Method to 'OAuth2'.
Click 'Done'. A Microsoft login window will appear. Sign in with your Outlook.com credentials and grant Thunderbird the necessary permissions to access your mailbox.
Manage Email Attachments Effortlessly with WPS Office
While resolving your Thunderbird and Outlook.com email configuration, consider equipping your device with WPS Office. It is a completely free, lightweight alternative to Microsoft Office that easily handles all your document, spreadsheet, and presentation attachments.
- 1. Download and Install: Download WPS Office for free from the official website and follow the quick installation process.
- 2. Save Attachments from Thunderbird: Right-click any Word, Excel, or PowerPoint attachment in your Thunderbird emails and select 'Save As'.
- 3. Open with WPS Office: Double-click the saved file to open and edit it instantly using WPS Writer, Spreadsheet, or Presentation.

Frequently Asked Questions
Why does Exchange Web Services (EWS) fail with my personal Outlook.com account?
EWS OAuth is specifically designed for enterprise and educational environments (Exchange Online tenants). Consumer Outlook.com accounts, even those attached to a Microsoft 365 Family subscription, do not typically support EWS protocols and require IMAP/SMTP connections.
What is OAuth2 and why is it needed for Thunderbird?
OAuth2 is a modern authentication protocol that provides enhanced security by allowing applications to access your account via secure tokens rather than storing your actual password. Microsoft mandates OAuth2 for third-party email clients connecting to Outlook.com.
Thunderbird still fails to connect after entering the IMAP settings. What should I check?
Double-check that the Authentication Method is strictly set to 'OAuth2' for both incoming (IMAP) and outgoing (SMTP) servers. Ensure you have no typos in the server hostnames (outlook.office365.com and smtp-mail.outlook.com) and verify that your firewall or antivirus is not blocking the connection ports.




