BusyCal: the setup order that holds up

Most BusyCal setups that go wrong do not fail on a missing feature. They fail on order. Events created with Quick Entry land in the wrong account because the default calendar was never chosen. A carefully arranged calendar set seems to reset itself. A two-week trial on the App Store gets fully configured, and then the perpetual license turns out to be a separate product that cannot inherit it. Each of these is cheap to avoid at the start and tedious to fix later. This guide lays out a setup sequence based on the developer's documentation, starting with the decisions that are hardest to reverse and ending with the ones that protect the setup once it works.

Step 1: choose the purchase route before the trial

BusyCal is distributed three ways:

• Direct store: a $49.99 perpetual license with 18 months of updates from the date of purchase.
• Mac App Store: a free download with a Free Edition, plus a premium subscription at $4.99 a month or $39.99 a year.
• Setapp: part of a bundle subscription, starting at $14.99 a month.

The developer states that purchases from these routes cannot be exchanged for one another. That makes the route the first decision, not the last. Configuring a trial on the App Store and then deciding to buy direct means cancelling any subscription and starting from the direct download.

A workable rule of thumb:

• Several years of use on personal Macs points to the direct license, which activates on up to 5 personal Macs with one registration code.
• A preference for reassessing tools every year, or for Family Sharing through Apple, points to the App Store subscription.
• Other Setapp apps already in daily use point to Setapp.

The direct and App Store trials both last 14 days. Setapp's lasts 7. Start the trial on the route that will actually be bought.

Step 2: permissions and the clock

On first launch, a Setup Assistant asks for three permissions:

• Contacts, used for birthdays, meeting invitations, email alarms, and address completion
• Location Services, used for weather at the current location
• Reminders, used to sync and display tasks

Skipping the assistant is recoverable. System Settings > Privacy & Security lets BusyCal be granted each of the three afterwards. The assistant itself appears only once, so the system settings are the place to look later.

The step people miss is the clock. The developer warns that Google authentication fails if the Mac's system time is wrong, and that an iCloud app-specific password can appear not to work for the same reason, with no obvious error. Open System Settings > General > Date & Time, turn on setting the time automatically, and only then move on to accounts.

Step 3: add every account inside BusyCal

BusyCal does not import accounts from System Settings.

For security reasons, BusyCal cannot automatically access account details already stored in macOS System Settings. Source: busymac.com

Accounts go in through BusyCal > Settings > Accounts, using the plus button at the lower left. Each service has its own catch.

iCloud

Generate an app-specific password on the Apple Account site before starting; the process is covered on Apple Support. Sign in with the primary iCloud address, not an alias, and use @icloud.com in place of an old @mac.com address. The same app-specific password can be reused on a second Mac running BusyCal, so store it somewhere secure rather than generating a new one each time.

Google

When Google shows its permission list, choose Select all before continuing. Removing any single permission breaks sync. Multiple Google accounts can be added separately and shown side by side. Once an account is connected, select it and set the sync frequency to Push, available since version 2022.3.1, so changes made elsewhere arrive faster.

Microsoft 365 and Exchange

BusyCal supports Microsoft Graph, Microsoft's newer sync method, as well as legacy Exchange Web Services. If company policy blocks adding the account at all, the Apple Calendar connection can bring those calendars in, but only as read-only events that cannot be edited or answered.

The iPhone side

BusyCal reaches an iPhone only through the same servers, so the phone needs matching accounts before anything appears there. For iCloud, open Settings on the phone, tap the Apple Account name, then iCloud, and turn on Calendars and Reminders. For Google, go to Settings > Apps > Calendar > Calendar Accounts > Add Account > Google and sign in. Shared Google calendars are not synced to iOS by default; they have to be ticked on Google's sync selection page for mobile devices first. Doing this during setup avoids the later impression that BusyCal "lost" a shared calendar, when it was never selected for the phone at all.

Step 4: decide what happens to On My Mac calendars

Anyone who has kept events in "On My Mac" calendars in Apple Calendar has a decision to make at this point. BusyCal does not sync or automatically import those calendars. They have to be exported from Apple Calendar as files and then imported into BusyCal.

Before importing, decide where each one should live. BusyCal syncs with an iPhone only through a server such as iCloud, Google, Exchange, or CalDAV, so a local calendar will never appear on the phone. Anything needed on the road belongs on iCloud or Google. Private records that should never leave the Mac can stay local on purpose.

Making that call calendar by calendar before importing avoids a later chore: dragging events one at a time from a local calendar into a synced one.

Step 5: set defaults before entering anything

With accounts in place, open BusyCal > Settings > General before creating a single event. The Quick Entry documentation notes that events go to the default event calendar unless another calendar is specified, which is the usual reason events turn up in an unexpected account.

Settings worth fixing now:

• Default calendar for Events, and the default for journal entries
• Default start time and default duration in minutes
• Week view shows: the default is 7 days from today. Options run from 2 to 31 days, plus 42 days and 90 days. Choosing One week instead pins the leftmost column to the start of the week rather than today.
• Month view shows: the default is 6 weeks from today, with options from 1 to 12 weeks, or a traditional One month layout.
• Day starts at, Day ends at, and the working days of the week

Two display controls are worth learning at the same time. Holding Option while scrolling in Day or Week view zooms the number of hours shown, which is easy to trigger by accident and easy to undo once known. The Working Hours button next to the date switcher collapses everything outside Day starts at and Day ends at, and that choice is remembered per smart filter, so a Work set can hide evenings while a Personal set shows them.

The "from today" ranges keep attention on what is coming next. The fixed week suits people who plan in calendar weeks. Either works; the point is to pick one on purpose rather than live with a layout nobody chose.

Step 6: build calendar sets, and learn the save rule

Calendar sets are saved groups of visible calendars. To make one, tick the calendars to show in the sidebar, choose Filter > New Smart Filter (Command-Control-N), enable Remember calendar set (visible calendars), and give it a name.

Sets appear in the Filter bar. Unfiltered sits on Command-Control-1, and the first saved set takes Command-Control-2. The developer suggests a starting group of five: Work, Personal, Focus with only the primary calendar, Everything, and Planning for projects and deadlines.

The rule that confuses people is how changes are kept. After choosing a set, ticking or unticking a calendar puts an asterisk next to the filter name, and that change is thrown away unless it is saved manually. The design lets someone glance at an extra calendar without wrecking a set that took time to build. When a set "keeps resetting", the asterisk is the first thing to check.

On the App Store route, having multiple smart filters and calendar sets is listed as a premium feature. That is worth knowing before building five of them during a trial on the free tier.

Step 7: entry, travel time, and blocking

Quick Entry

Quick Entry opens with Command-Option-N in the main window, or Command-Control-B from the menu bar. The documentation gives patterns such as "Dentist at 2:00 Monday alarm 15m" for an alarm 15 minutes before, "[45m]" at the end for a 45-minute event, and "allday" for an all-day event. Time zones can be typed inline, as in "Meeting May 1 9am America/New_York".

Travel time

Travel time needs two settings. Make the Travel Time field visible under Settings > Info Panel, and, if it should be added automatically whenever an event has a location, turn that on under Advanced Settings > Locations. The starting point comes from another event up to three hours earlier, or from the Me card's work or home address depending on the time of day, so check that the Me card actually holds both addresses.

Blocking personal time on a work calendar

A single event can be blocked by hand first, which is a good way to see the result before writing rules. Control-click the event, open the Block on calendar submenu, pick the destination, and choose Show as busy or Include details. The busy version copies nothing but the date and time.

For personal events that should appear as busy on a work calendar every time, Control-click the source calendar, choose Get Info, switch to the Automation tab, and add a rule. Each calendar takes up to three rules. For a shared work calendar, choose the style that shows the event as busy and removes all details, so only "[Busy]" and the time are copied. Automatic rules need version 2026.2.3 or later. Avoid editing the blocking copies by hand, since they are overwritten whenever the original changes.

Step 8: backups and the second Mac

BusyCal backs up calendars every 24 hours and keeps the last 10, adjustable under Settings > Backup. When something needs restoring, the option to restore as an "On My Mac" calendar is the safer path. It leaves current data untouched and lets individual events be dragged back into the right account, instead of overwriting a whole calendar and losing anything created since the backup. In practice: choose File > Restore From Backup, pick an older backup, select the calendar, tick the option to restore it as an On My Mac calendar, drag the missing events to the account they belong to, and then delete the temporary local calendar.

On a second Mac, signing in to the same iCloud account and installing BusyCal brings the account list across, along with preferences, tags, and smart filters. Passwords and tokens stay in each Mac's Keychain, so each listed account needs Use Account and a fresh sign in. A direct personal license covers up to 5 personal Macs with the same registration code.

What to change first

After setup, watch one ordinary week for where time still leaks: switching calendars, travel between meetings, or entering events. If entry is the slow part, compare approaches, including how Caltimate handles plans typed or spoken in plain language, and read the travel time guide if meetings in different places keep running into each other.