Glassmail

Help

Fix email errors

Every message Glassmail shows when an account won't connect, sync or send, and what to do about it.

Glassmail connects your Mac straight to your email provider, so most errors come from the provider. Find the message you saw below. If it isn't here, write to hi@glassmail.app with the exact words and a person replies, usually within a day. Never send a password.

Outlook.com, Hotmail and Microsoft 365

“Microsoft didn’t open this mailbox”

Microsoft signed you in but refused access to the mail.

  1. Check you can read your mail at outlook.live.com. If Microsoft asks you to verify your account or solve a puzzle there, do it.
  2. Open account.live.com/consent/Manage, choose Glassmail › Edit, and remove it.
  3. In Glassmail, add the account again and accept the permissions Microsoft shows.

“Turn on IMAP at Outlook.com”

Shown for accounts that Glassmail reads over IMAP. Outlook.com keeps IMAP off for new accounts.

  1. At outlook.live.com, open Settings › Mail › Forwarding and IMAP.
  2. Turn on Let devices and apps use IMAP and click Save.
  3. Wait a few minutes, then click Try again.

If it says “User is authenticated but not connected” even with IMAP on, that’s a known Microsoft problem with some personal accounts. Remove the account in Glassmail and add it again: Outlook.com, Hotmail, Live and MSN addresses now connect through Microsoft Graph, which isn’t affected.

“Microsoft signed this account out”

Your password changed, you removed Glassmail’s access, or Microsoft ended the sign-in. Open Glassmail › Settings › Accounts, choose the account and click Sign In Again…

Work or school account won’t connect

“Reading works, sending doesn’t yet”

For work and school accounts, Microsoft 365 often turns off Authenticated SMTP, which mail apps use to send. An administrator has to turn it on for your mailbox (Users › Mail › Manage email apps › Authenticated SMTP).

“This message is too large to send from an Outlook.com account”

Outlook.com and Hotmail accounts can send messages up to about 3 MB from Glassmail, attachments included. Share bigger files as a link, for example from iCloud Drive or OneDrive.

Gmail and Google Workspace

“Google didn’t accept that password”

  1. Use an app password, not your Google password. Make one at myaccount.google.com/apppasswords.
  2. Paste all 16 letters. The spaces don’t matter.
  3. If you deleted that app password in your Google account, make a new one and enter it in Settings › Accounts › Update Password…

The app passwords page says it’s not available

Gmail connects but mail doesn’t load

On some older accounts IMAP is off. In Gmail on the web, open Settings › See all settings › Forwarding and POP/IMAP, enable IMAP and save.

iCloud Mail

“Apple didn’t accept that password”

  1. Make an app-specific password at account.apple.com › Sign-In and Security › App-Specific Passwords. Your Apple Account password won’t work in mail apps.
  2. Paste it into Glassmail exactly as shown.

App-specific passwords need two-factor authentication on your Apple Account, which most accounts already have.

Yahoo and AOL

“Yahoo didn’t accept that password”

Make an app password in your Yahoo or AOL Account Security page (“Generate app password”), and use your full address as the username. Your normal password won’t work in mail apps.

Other providers and custom domains

“Couldn’t reach <server>”

“The server didn’t accept that password”

Mail stops arriving

“<Account> isn’t getting new mail”

Glassmail couldn’t check the account for a while. The warning shows in the menu bar and in the sidebar, with the reason.

Mail that won’t send

A message that couldn’t be sent stays under Not sent in the sidebar with the reason, so nothing is lost. Common replies from mail servers:

Still stuck?

The setup guides walk through adding each provider. Or write to hi@glassmail.app with the exact message you saw.

Glassmail is downloading

  1. 1Open Glassmail.dmg from your Downloads (bottom right of the Dock, or in Finder › Downloads).
  2. 2In the window that opens, drag Glassmail onto the Applications folder.
  3. 3Open Glassmail from Applications or Launchpad, and click Open if your Mac asks.

Download didn’t start? Try again · Step-by-step install guide