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#
- Open the provider's website and confirm the mailbox opens.
- In its security settings, allow mail apps (IMAP) if it asks.
- Create an app password if it offers one. A one-time security code isn't an app password.
- In Accounts, select Add accounts, then One account. Enter the address and the app password.
- Select Test sign-in, then Add account.
What each provider needs#
| Provider | Sign in with | Incoming server Mailman fills in |
|---|---|---|
| Gmail | App password | imap.gmail.com |
| Yahoo | App password, or an OAuth token with a Client ID and Client secret (optional) | imap.mail.yahoo.com |
| AOL | App password | imap.aol.com |
| iCloud (icloud.com, me.com, mac.com) | App password | imap.mail.me.com |
| GMX | Password | imap.gmx.com for gmx.com, gmx.us and gmx.co.uk. imap.gmx.net for other GMX domains |
| Outlook, Hotmail, Live, MSN | Sign in with Microsoft, or a password. See Outlook | outlook.office365.com |
| Microsoft 365 work or school | Sign in with Microsoft. See Outlook | outlook.office365.com |
| Any other domain | Password or app password | Enter 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 see | Do this |
|---|---|
| Bad creds | The provider rejected the details. Use the app password, not your normal password |
| No mailbox access | Sign-in worked, but the provider refused the mailbox. Make sure IMAP is allowed for the account |
| Locked | Only the account's owner can unlock it. Do that on the provider's website |
| Needs sign-in | For 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.