calmly

A calm CLI for macOS Calendar. Manage iCloud and local calendars without dialogs, prompts, or UI interruptions.

Why calmly?

• - AppleScript hangs — Calendar scripting often freezes waiting for permissions
• ICS imports pop dialogs — Can't automate without user interaction
• icalBuddy is read-only — Can't create events

calmly uses EventKit directly, so it works silently.

Installation

CODEBLOCK0

First run prompts for Calendar access (System Settings → Privacy → Calendars). One-time only.

Commands

List calendars

CODEBLOCK1

View upcoming events

CODEBLOCK2

Create all-day event

CODEBLOCK3

Create multi-day event

CODEBLOCK4

Create timed event

CODEBLOCK5

Batch Event Creation

For recurring events, loop in bash:

CODEBLOCK6

Date Verification

Before creating events, verify day/date alignment:

CODEBLOCK7

Notes

• - Dates use YYYY-MM-DD format
• Times use 24-hour HH:MM format
• Calendar names are case-insensitive
• Events sync to iCloud automatically
• No delete command yet — delete via Calendar app or iCloud web