This guide walks you through connecting your Gmail account to the built-in Mail app on macOS, so you can read, send, and manage your Gmail messages without opening a browser. It covers both the automatic setup (which works for most people) and the manual configuration for older Macs or special cases, plus fixes for the most common sync problems.
What You’ll Need
- A Mac running macOS (any recent version, from Mojave through Sonoma and later).
- Your Gmail address and password. If you use two-step verification (recommended), you’ll need an App Password instead of your regular password.
- An internet connection.
- If you have a Google Workspace account (company or school), the same steps apply, but your administrator may have restrictions.
Step-by-Step
Option 1: Automatic Setup (Recommended)
- Open the Mail app on your Mac. You’ll find it in the Dock or in the Applications folder.
- If this is your first time opening Mail, a setup assistant appears. Click Add Account (or Other Mail Account on some versions). If you already have accounts set up, go to Mail menu (top-left) → Settings (or Preferences on older macOS) → Accounts tab → click the + (plus) button.
- Select Google from the list of providers. If you don’t see it, choose Other Mail Account and skip to Option 2.
- Enter your full Gmail address (e.g., yourname@gmail.com) and click Continue.
- A Google sign-in window opens in your browser. Enter your Gmail password and follow any two-step verification prompts. If you have multiple Google accounts, make sure you pick the one you want to add.
- Google will ask for permissions. Click Allow to let Mail access your account. This is safe and only grants access to your email.
- After authorization, Mail may ask which apps to enable: Mail, Contacts, Calendars, and Notes. Check the ones you want (Mail is essential; the others are optional) and click Done.
- Mail will start syncing. Your Gmail inbox appears in the sidebar. Give it a minute or two for the first sync to complete.
Option 2: Manual Setup (IMAP)
Use this if automatic setup fails, or if you’re on an older macOS version that doesn’t list Google as a provider.
- Open Mail → Settings → Accounts → click +.
- Choose Other Mail Account (not Google).
- Enter your name, full Gmail address, and your Gmail password. Click Sign In.
- If it fails, click Continue to enter server details manually.
- For Incoming Mail Server, use:
imap.gmail.com. Port is 993, SSL is on. - For Outgoing Mail Server (SMTP), use:
smtp.gmail.com. Port is 587 (or 465 for SSL), and authentication is required. - Username: your full Gmail address. Password: your Gmail password (or App Password if you have 2-Step Verification on).
- Click Sign In. If prompted, verify the server certificates (they are legitimate).
- Choose which apps to sync (Mail, Contacts, etc.) and click Done.
If You Use Two-Step Verification
- Go to your Google Account in a browser: myaccount.google.com.
- Navigate to Security → 2-Step Verification → scroll to App passwords (you may need to re-enter your password).
- Create a new app password. Name it something like “Mac Mail”. Google generates a 16-character code.
- Use that code in place of your regular password when Mail asks for it.
Common Mistakes
- Using your regular password with 2-Step Verification: If you have two-step verification enabled, Google rejects your normal password in Mail. You must create and use an App Password.
- Choosing POP3 instead of IMAP: POP3 downloads emails to your Mac and deletes them from Gmail’s server, causing chaos across devices. Always select IMAP.
- Entering the wrong server port: For IMAP, port 993 with SSL is correct. For SMTP, port 587 with STARTTLS (or 465 with SSL) is correct. Using 25 often fails.
- Typing the full email address as the username: Yes, for Gmail you must use the full address (e.g., user@gmail.com), not just the part before the @.
- Clicking “Don’t Allow” during Google permission: If you deny access, Mail won’t sync. You can redo the process, but it’s easy to miss.
Tips
- Keep Gmail’s labels organized: In Mail, Gmail labels appear as folders. You can drag them to the sidebar to reorder, or hide ones you don’t use by right-clicking and choosing Get Info → uncheck Show.
- Set a sync frequency: In Mail → Settings → Accounts → select your Gmail → Mailbox Behaviors tab → adjust “Check for new messages” to every 5 or 15 minutes to balance battery life and freshness.
- Use the Gmail archive shortcut: In Mail, the Archive button (or keyboard shortcut Command+E) moves messages to “All Mail” in Gmail, not to trash. This matches Gmail’s behavior.
- Turn on “Safely store sent messages”: In Gmail settings (browser), under Settings → Accounts → Send mail as, check “When a message is marked as sent, show it in the Sent folder.” This prevents duplicate sent emails.
- Enable “Push” for faster delivery: If you have an iCloud or Exchange account, Mail supports push. For Gmail, it’s fetch-only, but you can set fetch to every 5 minutes for near-real-time.
Troubleshooting
- Mail says “Cannot connect to server”: Check your internet connection. Then try quitting Mail (Command+Q) and reopening. If it persists, verify the server settings match the manual ones above. Temporarily disable any VPN or firewall that might block ports 993/587.
- Password rejected even though it’s correct: This almost always means 2-Step Verification is on. Create an App Password (see above) and use that. If you don’t have 2-Step on, double-check for typos and capslock.
- Emails sync one-way only (you can’t send): Go to Mail → Settings → Accounts → select Gmail → Account Information tab → click Outgoing Mail Server (SMTP) → Edit SMTP Server List. Make sure the server is
smtp.gmail.com, port 587, and “Use only this server” is checked. Then click Advanced and verify “Use Secure Sockets Layer (SSL)” is checked (or “Use TLS” depending on version). - Mail shows duplicate folders or missing labels: Go to Mail → Settings → Accounts → Gmail → Mailbox Behaviors tab. Uncheck “Show” for folders you don’t need. If labels are missing, wait a few minutes; Gmail syncs labels slowly. If they never appear, remove the account and re-add it.
- Contacts or calendars don’t sync: In Mail → Settings → Accounts → Gmail, make sure the Contacts and Calendars checkboxes are ticked. If they are, but still not syncing, go to System Settings → Internet Accounts → select Google → and toggle Contacts/Calendars off and on again.
- Mail crashes or is extremely slow: This can happen if you have years of email. In Mail → Settings → Accounts → Gmail → Mailbox Behaviors tab, set “Check for new messages” to Manual, then restart Mail. Also consider archiving old emails in Gmail to reduce the load.
Frequently Asked Questions
Will this delete my emails from Gmail?
No. Using IMAP, Mail syncs with Gmail’s servers. Deleting a message in Mail moves it to Gmail’s Trash (or Archive if you use that button). Nothing is removed from your Google account unless you explicitly delete it there.
Can I use both Gmail’s web interface and Mac Mail at the same time?
Yes, absolutely. They sync in both directions. Changes you make in one appear in the other within seconds to a few minutes, depending on fetch settings.
Why does Gmail show “Less secure app access” in settings?
That setting is for older mail clients that don’t support modern authentication. Mac Mail uses OAuth (the same secure login as your browser), so you don’t need to enable “less secure apps.” If you see that option, leave it off.
How do I remove the Gmail account from Mac Mail?
Go to Mail → Settings → Accounts → select your Gmail account → click the minus (−) button. This removes it from Mail only; your Gmail data stays intact online.
Can I sync Gmail labels as folders?
Yes. Gmail labels appear as folders in Mail’s sidebar. Nested labels (like “Work/Projects”) appear as nested folders. You can’t create labels from Mail, but you can move messages into existing label folders.
Why are my sent emails not showing up in Gmail’s Sent folder?
Make sure you’re sending through the correct SMTP server. In Mail, go to Settings → Accounts → Gmail → Account Information → Outgoing Mail Server and confirm it’s smtp.gmail.com. Also check Gmail’s web settings: Settings → Accounts → “Send mail as” → verify the “When a message is marked as sent, show it in the Sent folder” option is checked.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- iOS 18 Safari Not Working? Fixes That Help
- How to Check Your Linux Kernel for Spectre
- iPhone Safe Mode: How to Enable or Disable It
- Fix Slow Internet Lag on Samsung Galaxy Note
- iPhone Personal Hotspot: How to Use It
- Google Play Protect: How It Secures Your Android