Fantastical Help

Getting started with Fantastical is simple, and we'll walk you through the process.

Creating a Flexibits account

When you first open Fantastical you'll be prompted to sign up for a Flexibits account. This is used to manage your subscription, sync calendar sets, templates, notifications, weather, and more. Flexibits does not use your data for commercial purposes, and you can read more about our data safeguarding practices in our privacy policy.

After signing up, you will be presented with your account key. This is used to secure your account data, and it is required to sign in to Fantastical on other devices if your devices do not share the same iCloud account.

Check your subscription status, view your account key, and sign out of your Flexibits account in Fantastical's Settings.

IMPORTANT: You only need a single Flexibits account for all of your devices. When you log in to your Flexibits account on other devices, choose the Sign In option and use the same login method that you used when you originally created your Flexibits account (either your email address and password directly, Sign in with Apple, or Sign in with Google).

If you don't use the same sign in method, you will end up with multiple accounts which cause sync and subscription problems.

Connecting calendar accounts

Video: Adding Your iCloud Account Video: Adding Your Google Account on Mac Video: Adding Your Exchange Account on Mac

You can connect calendar accounts (iCloud, Google, Exchange etc.) directly to Fantastical. Start by opening Fantastical, clicking the Fantastical menu and choosing Settings from the menu. You can also access the Settings by clicking on the Fantastical icon in your menu bar, clicking the gear icon in the lower right, and selecting Settings from the menu.

To add a new account, go to the Accounts tab in Settings.

1. Choose the "+" icon at the bottom of the sidebar on the left side of the window to open a panel with account type options.
2. Select the type of account you'd like to add and click Continue.
3. Fill in the credentials for the account to allow Fantastical to access and sync your events and tasks.

Adding an iCloud Account

Video: Adding Your iCloud Account

Apple requires that iCloud accounts have two-factor authentication enabled in order for apps to connect to iCloud's calendar or mail servers. If you don't have two-factor authentication enabled, enable two-factor authentication on your iCloud account before continuing.

iCloud with two-factor authentication

1. Log in to appleid.apple.com.
2. After login is completed, click on "App-specific passwords" under the Sign-In and Security section.
3. Give the app-specific password a name of your choosing (e.g. Fantastical).
4. A dialog will appear with a new password string that you can copy and paste into Fantastical.

Adding a Google account

Video: Adding Your Google Account on Mac

To add a Google account:

1. Select the Google account type.
2. Fill in your Google username (email address) and password.
3. Click "Sign In".
4. Click "Accept" to allow Fantastical to access your calendars.

Some Google Workspace organizations restrict access to third-party apps. We have more information about the Google scopes that Fantastical requests and how to add Fantastical as a trusted app to Google Workspace.

Once you've added your Google account you can enable shared calendars by clicking Manage Delegates... in the Accounts settings. See Delegated and shared calendars on Google and CalDAV servers for more information.

Adding an Exchange account

Video: Adding Your Exchange Account on Mac

To add an Exchange account:

1. Select the Exchange account type.
2. Fill in your Exchange email address and password.
3. Click "Add".
4. If you need to enter a username or Exchange URL, you will be prompted after clicking "Add".

Once you've added your Exchange account you can enable delegated or shared calendars by clicking Manage Delegates... in the Accounts settings. See Delegated and shared calendars on Exchange for more information.

If your organization uses Microsoft 365 then add your account as a Microsoft 365 account. If you are having trouble adding your Exchange account and you're not sure if your organization uses Microsoft 365, you can also try logging in to Microsoft 365 with your Exchange email address and password.

Adding a Microsoft 365 account

If your organization uses Microsoft 365 then it is better to add your account as a Microsoft 365 account rather than an Exchange account. This will allow Fantastical to connect using any single-sign-on or multi-factor authentication methods used by your organization.

To add a Microsoft 365 account using Microsoft EWS syncing:

1. Select the Microsoft 365 account type.
2. Log in to your Microsoft 365 account.

To add a Microsoft 365 account using Microsoft Graph syncing:

1. Hold down the option key + shift on your keyboard and select the Microsoft 365 account type
2. Log in to your Microsoft 365 account.

Please note, Microsoft Graph syncing doesn't support delegated calendars in Fantastical. However if the shared calendars are added to your account in the Microsoft web UI then they should show up in Fantastical as well.

Requesting access from an admin

Some organizations restrict access to third-party apps. If this is the case, you can request that your Microsoft 365 admin grant access to Fantastical by sending your admin the following URL. This will authorize Fantastical's client ID with the organization so that you can add your Microsoft 365 account.

https://login.microsoftonline.com/common/oauth2/authorize?response_type=code&client_id=395befa1-fd95-454c-8286-2948ada76320&resource=https%3A%2F%2Foutlook.office365.com%2F&redirect_uri=https%3A%2F%2Fflexibits.com%2Ffantastical&state=YT1odHRwcyUzQSUyRiUyRmxvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20lMkZjb21tb24mcj1odHRwcyUzQSUyRiUyRm91dGxvb2sub2ZmaWNlMzY1LmNvbSUyRg&prompt=admin_consent

Viewing Fantastical's Microsoft 365 OAuth scopes

If you use Fantastical in an organization, your admin may want to view the OAuth scopes Fantastical requests. Your admin can view this information here.

Adding a CalDAV account

1. Select the "Other CalDAV Account".
2. Enter your username, password, and the CalDAV server address.
3. Click "Add".

Adding a calendar subscription

Fantastical can also add a calendar subscription via an iCal URL, or using Fantastical's Interesting Calendars feature.

To add a calendar via an iCal URL, click File > New Calendar Subscription... Here, paste the URL of the calendar you want to subscribe to and it will be added to Fantastical.

To add a calendar via the Interesting Calendars feature, click File > Add Interesting Calendars... Here, search or browse for a calendar you want to subscribe to and click the + icon to add it to Fantastical.