Automation documentation

Automation and privacy

Connect popCalendar to scripts, other Mac apps, and Apple Shortcuts. Choose what each automation is allowed to do.

These guides cover popCalendar 1.3 and later. Some actions require a newer system version, as noted below.

Choose a connection

Use Shortcuts on Mac, iPhone, or iPad for actions you can combine visually. On Mac, use the command line for scripts or the URL scheme to present a calendar from another app. The Mac App Store and Setapp editions support both Mac interfaces.

Back to contents

Enable only the access you need

Open Settings > Automation & Privacy. All permission switches start off. They apply only to this device and are never synced or included in setup exports. Calendar access from the operating system is still required to read events.

PermissionWhat it does
Terminal calendarsMac only. Allows all read-only --terminal features independently of the other automation switches. Events still require calendar access granted in the app.
External app and CLI controlAllows Mac URL and CLI commands to control calendar windows. It does not grant private-data access or permission to change saved plans.
Automated private data accessAllows calendar-set and saved-plan queries, opening saved plans, working-day calculations, session queries, and image exports.
Automated changesAllows plan creation, changing the active calendar set, and pausing or resuming chimes. Duplicating a plan requires both private-data access and changes.

Other CLI data and change commands also require external control. Native Shortcuts actions need only their relevant data or change permission and require an unlocked device for those actions. Help, version, capabilities and diagnostics remain available without enabling automation permissions.

Back to contents

Keep control of your data

Basic Open Calendar actions remain available in Shortcuts. A date-selection action returns nothing until you explicitly confirm the selection. Choosing a different active calendar set on iPhone or iPad also requires Automated changes.

Permissions cover integrations on this device, not individual calling apps. A caller name, session name, or callback URL does not authenticate an app. Enable access only for integrations you trust. Turning off external control closes externally controlled calendar sessions. Revoking access does not erase data already returned to other apps.

Back to contents