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:
| Source | Best Method | Scope |
|---|---|---|
| Google Workspace | Microsoft Data Migration Service | Org-wide, bulk |
| Google Takeout (MBOX) | Outlook Desktop Import | Per-user |
| Gmail (personal) | IMAP bridge via Outlook Desktop | Per-user |
| G Suite Legacy | Microsoft Migration Tools | Per-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 → Migration → Data 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
source_email,destination_email
[email protected],[email protected]
[email protected],[email protected]
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
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 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:
- Verify domain in Microsoft 365 Admin Center (TXT record)
- Update MX records to Microsoft:
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 withp=none) - Autodiscover CNAME:
autodiscover.outlook.com - TTL: Lower TTL to 300 before cutover, restore to 3600 after 48h
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
references/validation-checklist.md for printable per-user checklist.Common Issues
| Issue | Fix |
|---|---|
| Migration stuck at connecting | Re-check Google service account permissions |
| Labels become nested folders | Expected — Google labels flatten to Outlook folders |
| Calendar recurring events broken | Complex recurrences may need manual recreation |
| Contacts missing phone numbers | Google exports differently — check import mapping |
| Large attachments missing | Items >150MB not migrated — export separately |
| Google Groups not migrating | Create Distribution Lists manually in Exchange Admin |
| Drive file links broken | Migrate files to OneDrive, update links manually |
| MX propagation slow | Check 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
references/client-templates.md for ready-to-use templates.Installation
openclaw install gmail-to-outlook
💻Code Examples
[email protected],[email protected]
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:source_email,destination_email
[email protected],[email protected]
[email protected],[email protected]Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.