calctl - Apple Calendar CLI

Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).

Requirements: brew install ical-buddy

Commands

| Command | Description | |---------|-------------| | calctl calendars | List all calendars | | calctl show [filter] | Show events (today, tomorrow, week, YYYY-MM-DD) | | calctl add <title> | Create a new event | | calctl search <query> | Search events by title (next 30 days) |

Examples

# List calendars
calctl calendars

# Show today's events
calctl show today

# Show this week's events
calctl show week

# Show events from specific calendar
calctl show week --calendar Work

# Show events on specific date
calctl show 2026-01-25

# Add an event
calctl add "Meeting with John" --date 2026-01-22 --time 14:00

# Add event to specific calendar
calctl add "Team Standup" --calendar Work --date 2026-01-22 --time 09:00 --end 09:30

# Add all-day event
calctl add "Holiday" --date 2026-01-25 --all-day

# Add event with notes
calctl add "Project Review" --date 2026-01-22 --time 15:00 --notes "Bring quarterly report"

# Search for events
calctl search "meeting"

Options for add

| Option | Description | Default | |--------|-------------|---------| | -c, --calendar <name> | Calendar to add event to | Privat | | -d, --date <YYYY-MM-DD> | Event date | today | | -t, --time <HH:MM> | Start time | 09:00 | | -e, --end <HH:MM> | End time | 1 hour after start | | -n, --notes <text> | Event notes | none | | --all-day | Create all-day event | false |

Available Calendars

Common calendars on this system:

• Privat (personal)
• Work
• Familien Kalender
• rainbat solutions GmbH
• TimeTrack