07 Setting Up Gmail in Apple Mail

You can access your Google Workspace email using Apple Mail on your Mac.

Adding Your Account

  1. Open Mail on your Mac
  2. Go to Mail → Settings (or Preferences on older macOS)
  3. Click the Accounts tab
  4. Click the + button to add an account
  5. Select Google and click Continue

Sign In with Google

  1. A Google sign-in window will open in your browser
  2. Enter your full Google Workspace email address
  3. Click Next
  4. Enter your password
  5. Complete two-factor authentication if prompted
  6. Click Allow to grant access

Choose What to Sync

After signing in, choose which items to sync:

  • Mail – Your email messages
  • Contacts – Your Google contacts
  • Calendars – Your Google calendars
  • Notes – Synced with Google Keep

Check the items you want and click Done.

How Gmail Translates to Apple Mail

  • Gmail Labels appear as folders in Apple Mail
  • Starred messages appear in a Starred/Flagged folder
  • Archive moves messages out of Inbox but keeps them in All Mail

Troubleshooting

If sign-in fails or you see authentication errors:

  • Ensure you're entering the correct password
  • Complete any two-factor authentication prompts
  • Check that your administrator hasn't restricted third-party app access
  • Try removing the account and adding it again

Contact your administrator if issues persist.

Still stuck? Ask us in the portal and we will come back to you.