Manual setup of Contacts.app on Mac OS X
The instructions and screenshots in this setup guide are for Mac OS X 10.12 (Sierra).
Previous versions of OS X may have slight differences. For best compatibility, we recommend upgrading your operating system to the latest version.
Mac contacts needs its 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 Mail, Contacts or Calendars on a Mac is via our automatic configuration tool.
If you'd like to manually configure your Calendar, read on:
Open Contacts.app, then from the menu bar select Contacts → Add Account….
Select Other Contacts account….
Leave the Account Type on CardDAV and Automatic then fill in your Fastmail email address, and password:
- User Name: Your full Fastmail username, including the domain.
- Password: Your Mac Contacts app password. (What is an app password?)
Click the Create button. The account will be created and Contacts.app will start syncing your contacts.
On versions of MacOS prior to 10.11 (El Capitan), you will also need the Server Address:
With some older versions of MacOS, there may be an error attempting to create. Click the Continue button to enter some additional details.
- Server Path:
<username@domain>replaced with your Fastmail username and domain)
- Example: If your email address is
firstname.lastname@example.org server path is
- SSL: Should be checked
When you click the Create button once more, the contacts will start syncing.
Note that due to OS limitations, Mac OS X only supports a single contact list.
For users in a multiple-user account, to see the shared
contacts instead of your personal contacts, set your username to
username+Shared@domain, substituting in your Fastmail username and
Be aware that any pre-existing contacts already on your device do not automatically get copied back up to Fastmail with the sync: you need to import them to Fastmail first.