Mac Mail, Calendar and Contacts apps need their own app password to access your information. If you use your normal password on an external account, syncing won't work and you will see a password error.
The easiest way to set up a Mac is to use our automatic setup tool which will take care of the app password entry for you.
- Log in to the Fastmail web interface on your Mac and go to the Settings → Privacy & Security screen. Click on the tab labelled Integrations.
- Click New App Password. A Verify it's you box will appear. Enter your password and click Continue. (For more information, see our Password-protected actions help page.)
- Give your app password a name to indicate which device and app this password is for.
- Choose what sort of access this password requires.
- Click Generate Password.
- The following screen will show information about the app password that has been created. Click the link that says Open this configuration file. This will download the configuration file to set everything up on your Mac automatically.
- Go to where the file was downloaded, and click on it to install the file. You'll see a notification telling you to review the file in your System Settings:
Go to System Settings, click Privacy & Security, then scroll down to Others and then Profiles. Double-click the newly downloaded profile, which will open a new window.
Examine the profile to make sure it has access to the options you require: email, contacts (CardDAV), and/or calendars (CalDAV). If everything looks good to you, click Install.
When you open your internet accounts list on your Mac, you'll see your accounts listed there. If you open the Profiles tool, you'll see a single entry for your Fastmail accounts.
Adding your other email addresses
To add addresses other than your username in Mac Mail:
- In Mac Mail, go to Mail → Settings.
- Select your Fastmail account on the left.
- Click the Email address dropdown, then Edit email addresses.
- On the following screen, click the + button to add a new address.
- Click OK when done.
In MacOS prior to 10.11 (El Capitan), you will instead need to replace your Fastmail username with the address you wish to send from in the Email Address field. You can also enter multiple email addresses, separated by a comma. If you do this, Mail.app will let you choose which one you would like to use each time you compose a message.
Setting up Notes
Warning: The new Notes features are available to OS X 10.11/iOS 9 users only if you are using Apple's upgraded Notes with iCloud support. These extra features are not available if you are using IMAP based Notes through Fastmail. If you don't need the new features, then we recommend you do not upgrade Notes support: once upgraded, you can't go back. Once a note goes onto iCloud, Fastmail will no longer be able to synchronize with it.
If your Mac is set up to access mail, contacts, and calendars, you can also add Notes support.
- Open Mail, go Mail → Preferences and select the Accounts tab to view your list of Accounts.
- Select your Fastmail account.
- Enable the Notes option in the toggle.
Updating your password
If you change your Mac Mail password after adding your Fastmail account to Mail.app, you will need to update the settings. The easiest way to update is to delete the profile off your Mac and use the automatic setup tool to generate a new password and store it on your Mac.
To delete the Fastmail account from your Mac, you will need to remove the profile. You can remove it by following these steps:
- Open System Preferences.
- Go to Internet Accounts.
- Select the Fastmail profile and use the - button to remove the profile.
This will remove Fastmail from the list of internet accounts on that Mac.