Manual setup of Calendar on Mac

The instructions and screenshots in this setup guide are for Mac OS X 14.1 (Sonoma). Previous versions of OS X should be similar. For best compatibility, we recommend upgrading your operating system to the latest version.

Mac Calendar 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.

Setting up Calendar

  1. Open Calendar. Go to CalendarAdd Account….
    Screenshot 2023-11-16 at 1.50.21 PM.png
  2. Select Other CalDAV Account…, then click Continue.
    Screenshot 2023-11-16 at 1.53.37 PM.png
  3. Leave the Account Type set to Automatic, then fill in your Fastmail username and password.
    • Email address: Your full Fastmail email address, including the domain.
    • Password: Your Calendar app password. (What is an app password?)
      Screenshot 2023-11-16 at 1.55.52 PM.png
  4. Click the Sign In button. The Calendar app will start syncing your calendars.

With some older versions of Mac, automatic calendar selection doesn't work. In this case, change the Account Type to Manual, then fill in your username, password, and the server address:

  • User Name: Your full Fastmail username, including the domain.
  • Password: Your Calendar app password. (What is an app password?)
  • Server Address:

    Screenshot 2023-11-16 at 1.58.05 PM.png

With some even older versions of MacOS, there may be an error at this point. Click the Create button again and you will be able to enter some additional details.

  • Server Path: /dav/principals/user/<username@domain>/ (with <username@domain> replaced with your Fastmail username and domain)
    • Example: If your email address is, the server path is /dav/principals/user/
  • SSL: Should be checked

Once this has been done, your calendars should start syncing.

Was this article helpful?
12 out of 25 found this helpful