Accounts

How to add iCloud Mail to LocalInbox

Add iCloud Mail (icloud.com, me.com, mac.com) to LocalInbox: create an app-specific password in your Apple Account and paste it in. Includes iCloud IMAP and SMTP settings.

In short

To add iCloud Mail to LocalInbox, sign in to your Apple Account, open Sign-In and Security, create an app-specific password named LocalInbox, then choose iCloud Mail in LocalInbox and paste it. It looks like abcd-efgh-ijkl-mnop.

Steps

  1. In LocalInbox, open Settings › Accounts and click Add Account (or use the welcome screen the first time).
  2. Choose iCloud Mail and enter your iCloud address.
  3. Click Open Apple Account and sign in. Open Sign-In and Security.
  4. Under App-Specific Passwords, create one named LocalInbox.
  5. Paste it into LocalInbox and click Add.

Apple Account: account.apple.com/account/manage. LocalInbox's own button opens the same page.

Server settings

ServerHost namePortSecurity
Incoming (IMAP)imap.mail.me.com993SSL/TLS
Outgoing (SMTP)smtp.mail.me.com587STARTTLS

Works for icloud.com, me.com and mac.com addresses.

Troubleshooting

LocalInbox says the password is wrong

Use the app password, not the password you sign in to the website with. If you've just made one, copy it again; it's shown only once.

LocalInbox says it can't connect

The message says what to fix: nothing answering at the port, the wrong kind of TLS for the port, an untrusted certificate, an unknown server name, or a timeout. Check the server settings below against the ones LocalInbox filled in.

Questions

Where does LocalInbox keep the password?

In the macOS Keychain on your Mac. It's never written to a file or sent anywhere except your mail server.

Does iCloud Mail need two-factor authentication?

Apple offers app-specific passwords only for Apple Accounts with two-factor authentication on, which is the default for most accounts.