Home › Knowledgebase › KB-129

How to fix Mac Mail app not syncing or receiving new emails

Summary

This guide helps you troubleshoot and resolve: How to fix Mac Mail app not syncing or receiving new emails. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

When Apple Mail stops syncing or fails to receive new messages, it can disrupt your workday significantly. Sync issues in the Mac Mail app are often caused by corrupted mailbox caches, outdated connection settings, or conflicts with third-party security software. This guide walks you through a series of troubleshooting steps to get your email flowing again.

Quick Fix Steps

Before diving into detailed troubleshooting, try these initial steps to resolve the most common sync issues.

Restart the Mail App and Your Mac

  1. Completely quit the Mail app by pressing Command + Q.
  2. Restart your Mac by clicking the Apple menu  in the top-left corner and selecting Restart.
  3. Open Mail again and check if new emails are downloading.

Check Apple's System Status

Before troubleshooting further, visit Apple's System Status page and confirm there are no outages affecting iCloud Mail or related services. If there is an outage, you will need to wait for Apple to resolve it.

Check Your Internet Connection

Ensure your Mac has an active internet connection. Try loading a webpage in Safari to confirm. If you are on a corporate or public network, certain ports may be blocked, preventing Mail from syncing.

Check Account Online Status

In macOS, individual mail accounts can be taken offline independently of one another. You must check the status of the specific account that is not syncing.

  1. Open the Mail app.
  2. Click the Mailbox menu in the top menu bar.
  3. Look at the list of accounts under the Take All Accounts Online option.
  4. If the affected account shows Offline, click its name to bring it back online.
If an account repeatedly goes offline, there may be an issue with your password or the mail server settings. Proceed to the Detailed Instructions below.

Detailed Instructions

If the quick fixes did not resolve the issue, follow these detailed steps to analyse and repair your Mail app.

Rebuild Your Mailbox

Rebuilding a mailbox forces the Mail app to re-download all messages and clear out corrupted data. This is the most effective fix for sync issues.

  1. Open the Mail app.
  2. In the left sidebar, select the mailbox or account that is not syncing.
  3. Click Mailbox in the top menu bar.
  4. Select Rebuild.
For large mailboxes, rebuilding can take a significant amount of time and may consume extra bandwidth. It is best to run this process when you do not need immediate access to your email.

Verify Connection Settings

Incorrect incoming or outgoing server settings will prevent Mail from syncing properly.

  1. Open the Mail app.
  2. Click Mail in the top menu bar and select Settings (or Preferences on older macOS versions).
  3. Click the Accounts tab.
  4. Select the affected account from the list on the left.
  5. Review the Account Information and Server Settings tabs to ensure the incoming and outgoing server addresses are correct.
If you are unsure of the correct server settings for your email account, please check your original setup documentation or contact your email provider for assistance.

Microsoft 365 and Exchange Account Troubleshooting

Many Australian small businesses use Microsoft 365 or Exchange. These accounts often require specific authentication methods that differ from standard IMAP accounts.

OAuth2 Authentication Issues

Modern Microsoft 365 accounts use OAuth2 for authentication. If your password has recently changed or two-factor authentication (2FA) is enabled, Mail may fail to sync because the OAuth token has expired or been revoked.

  1. Open the Mail app.
  2. Click Mail in the top menu bar and select Settings.
  3. Go to the Accounts tab and select your Microsoft 365 or Exchange account.
  4. Look for an authentication status indicator. If it shows Account offline or Authentication failed, click the account to re-authenticate.
  5. Follow the browser-based sign-in prompt that appears to re-authorise Mail to access your Microsoft 365 account.

App-Specific Passwords

If your Microsoft 365 or iCloud account has two-factor authentication enabled, the standard Mail app login may fail. You may need to generate an app-specific password.

  1. Sign in to your Microsoft account security page at account.microsoft.com/security or your Apple ID account page at appleid.apple.com.
  2. Navigate to the Security or App passwords section.
  3. Generate a new app-specific password for Mac Mail.
  4. Return to the Mail app Settings > Accounts.
  5. Select your account and update the password field with the new app-specific password.
App-specific passwords are different from your main account password. They are used specifically for third-party or native apps that do not support modern browser-based authentication.

Clear Cached Mail Data

Sometimes the Mail app's cache becomes corrupted and prevents new emails from displaying. Clearing the cache forces the app to fetch fresh data.

  1. Quit the Mail app by pressing Command + Q.
  2. Open Finder.
  3. Press Command + Shift + G to open the "Go to Folder" window.
  4. Paste the following path and press Go: ~/Library/Mail/V10 (substitute V9 or V8 if your macOS version uses an older folder).
  5. Inside this folder, locate the files named Envelope Index, Envelope Index-shm, and Envelope Index-wal.
  6. Move only these three files to the Trash. Do not delete or move any other files or folders.
  7. Empty the Trash.
  8. Reopen the Mail app. It will take some time to re-download your messages.
Clearing the envelope index will remove locally cached message data. Your emails remain safely stored on the server and will re-download when you reopen the Mail app, but this requires an active internet connection.

Check IMAP Folder Subscriptions

If you are using an IMAP account and certain folders or emails are missing, the issue may be related to folder subscription settings. Mail only downloads folders that you have explicitly subscribed to.

  1. Open the Mail app.
  2. In the sidebar, right-click (or Control-click) on your email account name.
  3. Select IMAP Folders or Account Information depending on your macOS version.
  4. Review the list of available folders on the server.
  5. Ensure the folders you expect to see (such as Inbox, Sent, Drafts, and custom folders) are checked or marked as Subscribed.
  6. Click OK or Apply to save your changes.
Unsubscribing from folders will hide them from the Mail sidebar and stop new messages in those folders from syncing to your Mac.

Keychain Access Troubleshooting

The Mac Mail app stores email passwords and authentication tokens in the macOS Keychain. If the Keychain is locked, corrupted, or out of sync with your account password, Mail may be unable to authenticate with the mail server.

  1. Open Finder and go to Applications > Utilities.
  2. Double-click Keychain Access to open it.
  3. In the search bar at the top right, type your email address or the name of your email provider (for example, "outlook", "office365", or "icloud").
  4. Look for entries labelled as Internet password or Exchange.
  5. Double-click the entry and click Show password. You may need to enter your Mac administrator password.
  6. If the stored password is incorrect or missing, delete the entry by selecting it and pressing Delete.
  7. Restart the Mail app. You will be prompted to re-enter your email credentials, which will be saved to the Keychain.

Troubleshooting

Check for macOS and Mail Updates

Outdated software can cause compatibility issues with mail servers.

  1. Click the Apple menu  and select System Settings (or System Preferences on older macOS versions).
  2. Click General, then Software Update.
  3. Install any available updates for macOS.

Disable Antivirus or Firewall Interference

Third-party antivirus software or strict firewall settings can block the ports Apple Mail uses to communicate with servers.

Remove and Re-add the Account

If none of the above steps work, removing and re-adding the account can resolve deep-rooted configuration issues.

  1. Open the Mail app.
  2. Click Mail in the top menu bar and select Settings.
  3. Go to the Accounts tab and select the problematic account.
  4. Click the – (minus) button at the bottom of the list to remove the account.
  5. Confirm the removal.
  6. Click the + (plus) button to add the account back and follow the prompts to enter your credentials and server settings.
Removing an account will delete all locally stored emails for that account. If you are using a POP3 account, ensure you have backed up any important emails before proceeding, as they may not be retrievable from the server.

If you have completed all troubleshooting steps and your Mac Mail app is still not syncing or receiving emails, please Open a Ticket for further assistance from our support team.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket