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 contentsEnable 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.
| Permission | What it does |
|---|---|
| Terminal calendars | Mac 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 control | Allows 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 access | Allows calendar-set and saved-plan queries, opening saved plans, working-day calculations, session queries, and image exports. |
| Automated changes | Allows 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 contentsKeep 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