Apple Mail and Gmail used to be a fight: Gmail’s labels confused Apple Mail’s folder model, IMAP sync would crawl through 80,000 messages, and a half-moon “loading” indicator would spin for hours while you couldn’t search. As recently as 2023 the recommended advice was “just use the Gmail web app.” That changed with macOS Sonoma’s Mail rewrite and the proper modern-OAuth path. Today Apple Mail with a Gmail account is genuinely fast and pleasant — but only if you set it up right.
This is the version that actually works in 2026: OAuth (no app passwords), the IMAP folder strategy that doesn’t drown you, and the rules that catch what Gmail’s filters miss.
Step 1 — Add the Gmail account with OAuth, not a password
Two-factor accounts on Google can no longer use plain IMAP passwords (and you really shouldn’t use the deprecated “app password” workaround either). The right path:
- System Settings → Internet Accounts → Add Account → Google. NOT “Other Mail Account.”
- A real Google sign-in popup appears. Sign in, complete 2FA. The consent screen will ask for Mail, Contacts, Calendar, Notes — toggle to taste. For mail-only, leave Mail on, others off.
- After consent, you’re back in System Settings. The account is added with an OAuth refresh token. No password is stored anywhere on your Mac — macOS holds a refresh token in the Keychain and exchanges it for short-lived access tokens.
Open Mail. The Gmail account is in the sidebar with all your mailboxes — Inbox, Drafts, Sent, plus Google’s special folders (All Mail, Spam, Bin). It will start syncing.
Step 2 — fix the folder situation before sync runs forever
This is the historical pain point. Gmail uses labels (one message can have multiple), but exposes them to IMAP as folders. The default mapping is: every label = a folder, plus an “All Mail” folder that contains every message. So a message with three labels appears in four places in Apple Mail. Sync downloads it four times.
Fix it on Gmail’s side, not Apple’s. In Gmail web settings → Labels:
- For every label you don’t actively organize by — promotional, social, forums, automated alerts — uncheck Show in IMAP. Apple Mail won’t see those folders at all; the messages still exist in All Mail.
- For the system folders — Important, Starred, Chats, Scheduled — also uncheck Show in IMAP. They double-count messages without adding value.
- Leave Show in IMAP on for: Sent, Drafts, Spam (Bin), All Mail, and any custom labels you actually use as folders.
Then in Gmail settings → Forwarding and POP/IMAP → Folder Size Limits: set “Limit IMAP folders to contain no more than this many messages” to 1000. That tells the IMAP server: when Apple Mail asks for All Mail, only show the most recent 1000 messages. The rest still exist; if you search, server-side search finds them. But the local cache stays small and fast.
Save. Apple Mail re-syncs in seconds instead of hours.
Step 3 — Mail’s preferences that matter
In Mail → Settings:
- General → Check for new messages: Manually — or every 5 minutes if you want notifications. The default “Automatically” uses IMAP IDLE which is fine on a stable connection but burns battery on flaky networks.
- Accounts → Gmail → Mailbox Behaviors:
- Drafts: Store on server (so phone sees them).
- Sent: Store on server.
- Junk: Store on server.
- Trash: Move deleted messages to the Trash mailbox: ON. Without this, Apple Mail and Gmail disagree about what “delete” means — Gmail thinks delete = archive (move to All Mail), Apple thinks delete = move to Bin. Turning this on aligns them.
- Viewing → List preview: 1 line. Default is 2; 1 lets you see twice as many messages.
- Viewing → Show most recent message at the top: ON. Otherwise Mail’s default is “oldest at top of thread,” which is not how anyone reads email.
Step 4 — the rule Gmail filters can’t replicate
Gmail’s server-side filters are great for moving messages by sender / subject / has-attachment. They can’t do local actions: play a sound, bounce to Dock, mark as “not Junk,” mark as Read. Apple Mail’s local rules can. The combination is more powerful than either alone.
Mail → Settings → Rules. Two rules I always set up:
Rule 1 — "Auto-archive newsletters from known senders"
If: From contains @substack.com OR @stratechery.com OR ...
Then: Mark as Read
Move Message to mailbox "Newsletters"
Rule 2 — "Stop bouncing for non-VIPs after hours"
If: Date Received is between 22:00 and 07:00
AND Sender is NOT in VIPs
Then: Mark as Read
Don't Notify
Rule 1 keeps the inbox clean. Rule 2 means I see the email in the morning, I don’t get pinged at 1 AM by some marketing drip campaign. Neither rule is doable in Gmail’s filter UI — both require client-side logic.
Step 5 — the smart mailbox for inbox-zero people
Smart Mailboxes are saved searches that look like real folders. The one I rely on:
- Today: Date Received is in the last 24 hours AND in Inbox.
- Awaiting Reply: I sent the message AND no reply received in the same thread within 48 hours. (Mail can’t do this directly — you set Date Received older than 48 hours and Sent by Me.)
- Unsubscribe: From contains “@” AND Subject does not contain “Re:” AND has “unsubscribe” in the body. Useful for bulk-cleanup days.
Smart Mailboxes are local-only — they don’t sync to iOS — but on the Mac they make “what do I actually need to look at right now” a one-click answer.
When to NOT use Apple Mail with Gmail
If you live inside Gmail’s UI — you use canned responses, snooze, native Calendar/Meet integration, the categorized inbox tabs — Apple Mail loses all of that. The IMAP layer can’t expose those features. Apple Mail is best when you mostly want to read, write, search, and apply rules. If you actively use Gmail’s productivity features, the web app or the Gmail iOS app are still better.
For everyone else — the “I just want a clean inbox app that doesn’t make me stay in Chrome” case — the configuration above is what makes Apple Mail finally work with a Gmail account in 2026 without the historic sync hellishness.
Photo: Working on a MacBook at a desk by Burst on Pexels.