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 instructions and screenshots in this setup guide are for macOS 13.5 (Ventura). Previous versions of OS X should be similar. For best compatibility, we recommend upgrading your operating system to the latest version.
The easiest way to configure Mail, Contacts or Calendars on a Mac is via our automatic configuration tool. If you prefer to configure your contacts manually, this page is for you.
Setting up Contacts
Open Contacts. Go to Contacts → Add Account.
Select Other Contacts Account..., then click Continue.
Leave the Account Type set to CardDAV and Automatic, then fill in your Fastmail email address and password:
- Email address: Your full Fastmail email address, including the domain.
- Password: Your Contacts app password. (What is an app password?)
Click the Sign In button. Contacts will start syncing your contacts.
With some older versions of Mac, there may be an error attempting to create. Click the Continue button to enter some additional details:
<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
Once this has been done, contacts should start syncing.
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.
Shared contacts in a multi-user account
For users in a multi-user account, you can set up shared contacts by following these steps:
Open Contacts and go to Contacts → Add Account.
Select Other Contacts Account... and click Continue.
Leave the Account Type on CardDAV and Automatic.
Enter your username as
username+Shared@domain.com(substituting your Fastmail username and domain accordingly) and enter your app password.
Click Sign In.