Help menu Add & manage accounts

Gmail, Yahoo, iCloud and other providers

What each provider needs, and which incoming server Mailman fills in for you.

Works in: Windows app5 minUpdated 2026-11-07

Your provider decides which mail apps can connect. Most want an app password instead of your normal one, and an administrator can block mail apps altogether.

Connect the account 5 min#

  1. Open the provider's website and confirm the mailbox opens.
  2. In its security settings, allow mail apps (IMAP) if it asks.
  3. Create an app password if it offers one. A one-time security code isn't an app password.
  4. In Accounts, select Add accounts, then One account. Enter the address and the app password.
  5. Select Test sign-in, then Add account.

What each provider needs#

ProviderSign in withIncoming server Mailman fills in
GmailApp passwordimap.gmail.com
YahooApp password, or an OAuth token with a Client ID and Client secret (optional)imap.mail.yahoo.com
AOLApp passwordimap.aol.com
iCloud (icloud.com, me.com, mac.com)App passwordimap.mail.me.com
GMXPasswordimap.gmx.com for gmx.com, gmx.us and gmx.co.uk. imap.gmx.net for other GMX domains
Outlook, Hotmail, Live, MSNSign in with Microsoft, or a password. See Outlookoutlook.office365.com
Microsoft 365 work or schoolSign in with Microsoft. See Outlookoutlook.office365.com
Any other domainPassword or app passwordEnter IMAP host and IMAP port yourself

Every server above uses port 993. Sending can need separate outgoing settings; see Write and reply. Mailman can't get around a provider's restrictions.

If something went wrong#

You seeDo this
Bad credsThe provider rejected the details. Use the app password, not your normal password
No mailbox accessSign-in worked, but the provider refused the mailbox. Make sure IMAP is allowed for the account
LockedOnly the account's owner can unlock it. Do that on the provider's website
Needs sign-inFor Yahoo, update the refresh token, client ID and client secret in Sign-in & 2FA

See An account won't sync for every status.

Stay connected#

Check Stay connected in an account's Connection settings to get new mail within seconds. It keeps one connection open per account while Mailman is open on your computer, for up to 50 accounts.

  • Mailman catch-alls: one connection to your catch-all.
  • Gmail: about 15 connections per account, shared with other mail apps.
  • Yahoo and AOL: only a few connections; another app on the account may be signed out or briefly blocked.
  • GMX and Web.de: only a few connections; quiet connections drop and Mailman reconnects. Another app may be briefly blocked.
  • iCloud and other IMAP: one connection.
  • With a proxy: uses one of the proxy's connections. "Waiting for the proxy" means it paused for a minute so sync could use the proxy.

See Stay connected to turn it on or off.

What's next