Automatic setup of email, calendar and contacts on Mac

Mac Mail, Calendar and Contacts apps needs their own app password to access your information. If you use your normal password or your Fastmail two step verification password on an external account, syncing to an external service won't work and you will see a password error.

The easiest way to configure a Mac is to use our automatic configuration tool which will take care of the app password entry for you.

  1. Log in to the Fastmail web interface from your Mac and go to the Password & Security screen and unlock it with your password.
  2. Use the "New App Password" button.
    1. Give your app password a name to indicate which device and app this password is for.
    2. Choose what sort of access this password requires.
  3. Generate password.
  4. The screen will show a link for automatic configuration on a Mac. Use the link.
  5. You will be prompted to open a new configuration profile.
  6. Examine the configuration profile ("Show Profile") and make sure it has access to which of email, contacts (CardDAV) and calendars (CalDAV) you require, and install it if it's correct.
  7. You're done!

If 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.

Looking for instructions on how to manually configure Mail, Calendar, or Contacts?

Adding your other email addresses

To use a different email address to your Fastmail username:

  1. Go to MailPreferences and select the Accounts tab.
  2. Select your Fastmail account on the left.
  3. Use the Aliases pop up menu to access your alternate addresses.

  4. Use the Edit Aliases option to add, delete or change your list of alternate addresses.

In MacOS prior to 10.11 (El Capitan), there is no aliases option. Instead, in the Email Address field, replace your Fastmail username with the address you wish to use instead. 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 synchronise with it.

Add Notes support to your Mail account.

  1. Open Mail, go MailPreferences and select the Accounts tab to view your list of Accounts.
  2. Select your Fastmail account.
  3. 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 configuration tool to generate a new password and store it on your Mac.

If you'd prefer to update your passwords manually: Mail, Calendar, and Contacts.

Remove a Fastmail Profile

To delete Fastmail from your Mac, you need to remove the Profile.

  1. Open System Preferences
  2. Go to Profiles
  3. 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.