Overview
This article explains the supported and recommended methods for exporting email from Google Gmail and importing it into Microsoft 365. The correct method depends on whether you are migrating a single mailbox or an entire organization, and whether administrative access to Google Workspace is available.
Option 1 - Microsoft 365 Google Workspace Migration (Recommended)
This is the preferred method for full mailbox or tenant-wide migrations.
Use this method if:
- You are migrating one or more full mailboxes
- You want folders and labels preserved
- You have admin access to both Google Workspace and Microsoft 365
What is migrated:
- Email (Inbox, Sent, Drafts, folders)
- Gmail labels converted to folders
- Read and unread status
- Timestamps and attachments
Requirements:
- Google Workspace Admin access
- Microsoft 365 Global Administrator access
- Gmail API enabled
Step 1 - Prepare Google Workspace
- Log in to the Google Admin Console
- Enable the Gmail API
- Confirm IMAP access is enabled for users
- Create or authorize a service account or OAuth access for migration
Step 2 - Prepare Microsoft 365
- Log in to the Microsoft 365 Admin Center
- Navigate to Setup > Data Migration
- Select Google Workspace as the source
- Create a new migration project
- Authenticate Google Workspace access
- Map Gmail users to Microsoft 365 mailboxes
Step 3 - Run the Migration
- Perform a test migration
- Start the full migration
- Allow synchronization to complete
- Perform a final sync before changing MX records
Option 2 - Google Takeout (MBOX) Export and Import
This method is commonly used when Google Workspace admin access is not available.
Step 1 - Export Gmail Using Google Takeout
- Visit Google Takeout
- Select Deselect all
- Enable Mail
- Choose export format MBOX
- Download the archive when complete
Step 2 - Import MBOX into Microsoft 365
Microsoft 365 does not support direct MBOX imports. One of the following methods must be used.
Method A - Thunderbird (Free)
- Install Thunderbird
- Import the MBOX file
- Add the Microsoft 365 mailbox using IMAP
- Drag folders from Gmail into Microsoft 365
Method B - MBOX to PST Conversion
- Convert MBOX to PST using a third-party tool
- Upload the PST using the Microsoft 365 Import Service
- Map the PST file to the correct mailbox
Option 3 - IMAP Migration (Basic Email Only)
This option is suitable for email-only migrations with limitations.
Steps
- Enable IMAP in Gmail
- Navigate to Setup > Data Migration > IMAP in Microsoft 365
- Enter Gmail IMAP server details
- Provide user credentials or app passwords
- Start the migration
Limitations:
- Gmail labels may flatten
- Sent items may not migrate perfectly
- Calendars and contacts are not migrated
Notes
- If users will continue using Gmail during migration, run the initial migration first, allow mail to sync, then perform a final delta sync before changing MX records
- Changing MX records should always be the last step in any migration method