✓ Verified 💻 Development ✓ Enhanced Data

Gmail To Outlook

Migrate email, contacts, and calendars from Google Workspace (Gmail) to Microsoft 365 (Outlook/Excha

Rating
4.2 (362 reviews)
Downloads
939 downloads
Version
1.0.0

Overview

Migrate email, contacts, and calendars from Google Workspace (Gmail) to Microsoft 365 (Outlook/Exchange Online).

Complete Documentation

View Source →

Gmail to Outlook Migration

Migration Paths

Assess the source environment first:

SourceBest MethodScope
Google WorkspaceMicrosoft Data Migration ServiceOrg-wide, bulk
Google Takeout (MBOX)Outlook Desktop ImportPer-user
Gmail (personal)IMAP bridge via Outlook DesktopPer-user
G Suite LegacyMicrosoft Migration ToolsPer-user or bulk

Pre-Migration Checklist

Run through this with the client before touching anything:

  • Inventory — Number of users, total mailbox sizes, largest mailbox, shared mailboxes, Google Groups
  • Microsoft 365 plan — Confirm active subscription, verify admin access (Global Admin required)
  • Source admin access — Google Workspace Super Admin + service account for bulk migration
  • DNS access — Whoever manages MX records (registrar, Cloudflare, etc.)
  • Data scope — Email only? +Contacts? +Calendars? +Drive files?
  • Cutover window — When to switch MX records (weekend recommended)
  • Client communication — Draft email to users about the switch, new login instructions
  • Retention — Keep Google Workspace active 30 days post-migration as safety net

Method 1: Microsoft Data Migration Service (Recommended for Google Workspace)

Best for org-wide migrations from Google Workspace to Microsoft 365.

Setup

  • Microsoft 365 Admin Center → MigrationData Migration
  • Select Google Workspace as source
  • Create service account in Google Admin Console with domain-wide delegation
  • Upload service account key file to Microsoft migration tool
  • Select what to migrate: Email, Contacts, Calendars
  • Choose date range filter (optional — migrate only last N months to save time)

Execution

  • Add users to migrate (CSV upload for bulk: source_email,destination_email)
  • Start migration — Microsoft handles delta sync automatically
  • Monitor progress in Admin Center → shows per-user status
  • Migration runs in background — users can keep using Gmail during this phase

CSV Format

See references/csv-template.md for full template with notes.

Method 2: Google Takeout + Outlook Import

Best for individual users or when bulk migration fails.

Export from Google

  • Go to Google Takeout: https://takeout.google.com
  • Select Mail, Contacts, Calendar
  • Choose MBOX format for mail (compatible with Outlook)
  • Download archive when ready (can take hours/days for large mailboxes)

Import to Outlook

  • Email: Outlook Desktop → File → Open & Export → Import/Export → Import from MBOX
  • Contacts: Import Google CSV to Outlook contacts
  • Calendar: Export Google Calendar as ICS, import to Outlook Calendar
Limitations: Manual per-user process, requires desktop Outlook, size limits.

Method 3: IMAP Bridge (Manual / Small Scale)

For personal Gmail accounts or when other methods fail:

  • Enable IMAP in Gmail: Settings → Forwarding and POP/IMAP → Enable IMAP
  • Create app password for Gmail account
  • In Outlook desktop, add Gmail as IMAP account using app password
  • Set up Microsoft 365 account in same Outlook profile
  • Drag-and-drop folders from Gmail IMAP to Microsoft 365 mailbox

Data Mapping Considerations

Gmail FeatureOutlook EquivalentNotes
LabelsFoldersMultiple labels become copies in folders
Google GroupsDistribution ListsMay need manual recreation
Google Drive linksOneDrive linksLinks break — migrate files separately
Gmail filtersOutlook rulesManual recreation required
Hangouts/Chat historyTeamsNot directly migratable

DNS / MX Cutover

After migration data is transferred:

  • Verify domain in Microsoft 365 Admin Center (TXT record)
  • Update MX records to Microsoft:
text
Priority  Host
   0         company-com.mail.protection.outlook.com
  • Set SPF: v=spf1 include:spf.protection.outlook.com ~all
  • Set DKIM: Admin Center → Defender → Email authentication → Enable DKIM
  • Set DMARC: v=DMARC1; p=none; rua=mailto:[email protected] (start with p=none)
  • Autodiscover CNAME: autodiscover.outlook.com
  • TTL: Lower TTL to 300 before cutover, restore to 3600 after 48h
See references/dns-records.md for copy-paste DNS templates.

Post-Migration Validation

Run these checks for every user:

  • [ ] Email receiving on Outlook (send test from external)
  • [ ] Historical emails present (spot-check oldest + newest)
  • [ ] Folders mapped correctly (labels→folders)
  • [ ] Contacts imported (check count vs Google)
  • [ ] Calendar events present (check recurring events specifically)
  • [ ] Google Groups recreated as Distribution Lists
  • [ ] Signatures set up in Outlook
  • [ ] Mobile devices re-configured (Outlook app or Exchange)
  • [ ] Gmail IMAP disabled or account removed
See references/validation-checklist.md for printable per-user checklist.

Common Issues

IssueFix
Migration stuck at connectingRe-check Google service account permissions
Labels become nested foldersExpected — Google labels flatten to Outlook folders
Calendar recurring events brokenComplex recurrences may need manual recreation
Contacts missing phone numbersGoogle exports differently — check import mapping
Large attachments missingItems >150MB not migrated — export separately
Google Groups not migratingCreate Distribution Lists manually in Exchange Admin
Drive file links brokenMigrate files to OneDrive, update links manually
MX propagation slowCheck TTL, use dig MX domain.com to verify

Deliverables Template

For client-facing migration projects, prepare:

  • Migration Plan — Timeline, phases, user batches, rollback plan
  • User Communication — Email template announcing the switch
  • Admin Runbook — Step-by-step for the migration operator
  • Validation Report — Per-user sign-off checklist
See references/client-templates.md for ready-to-use templates.

Installation

Terminal bash

openclaw install gmail-to-outlook
    
Copied!

💻Code Examples

[email protected],[email protected]

janecompanycomjanecompanyonmicrosoftcom.txt
See `references/csv-template.md` for full template with notes.

## Method 2: Google Takeout + Outlook Import

Best for individual users or when bulk migration fails.

### Export from Google

1. Go to Google Takeout: https://takeout.google.com
2. Select **Mail**, **Contacts**, **Calendar**
3. Choose MBOX format for mail (compatible with Outlook)
4. Download archive when ready (can take hours/days for large mailboxes)

### Import to Outlook

1. **Email**: Outlook Desktop → File → Open & Export → Import/Export → Import from MBOX
2. **Contacts**: Import Google CSV to Outlook contacts
3. **Calendar**: Export Google Calendar as ICS, import to Outlook Calendar

**Limitations**: Manual per-user process, requires desktop Outlook, size limits.

## Method 3: IMAP Bridge (Manual / Small Scale)

For personal Gmail accounts or when other methods fail:

1. Enable IMAP in Gmail: Settings → Forwarding and POP/IMAP → Enable IMAP
2. Create app password for Gmail account
3. In Outlook desktop, add Gmail as IMAP account using app password
4. Set up Microsoft 365 account in same Outlook profile
5. Drag-and-drop folders from Gmail IMAP to Microsoft 365 mailbox

## Data Mapping Considerations

| Gmail Feature | Outlook Equivalent | Notes |
|---------------|-------------------|-------|
| Labels | Folders | Multiple labels become copies in folders |
| Google Groups | Distribution Lists | May need manual recreation |
| Google Drive links | OneDrive links | Links break — migrate files separately |
| Gmail filters | Outlook rules | Manual recreation required |
| Hangouts/Chat history | Teams | Not directly migratable |

## DNS / MX Cutover

After migration data is transferred:

1. **Verify domain** in Microsoft 365 Admin Center (TXT record)
2. **Update MX records** to Microsoft:
example.txt
source_email,destination_email
[email protected],[email protected]
[email protected],[email protected]

Tags

#web_and-frontend-development

Quick Info

Category Development
Model Gemini 2.0
Complexity One-Click
Author luigi08001
Last Updated 3/10/2026
🚀
Optimized for
Gemini 2.0
💎

Ready to Install?

Get started with this skill in seconds

openclaw install gmail-to-outlook