Calendar
Read-only access to macOS Calendar.app via icalBuddy.
Prerequisites
bash
brew install ical-buddy
Commands
List Calendars
bash
icalBuddy calendars
Today's Events
bash
# All calendars icalBuddy eventsToday # Specific calendar icalBuddy -ic "mkane@cloudflare.com" eventsToday # Compact format (no notes/attendees) icalBuddy -eep notes,attendees -ic "mkane@cloudflare.com" eventsToday
Upcoming Events
bash
# Today + next 3 days icalBuddy -ic "mkane@cloudflare.com" eventsToday+3 # From now only (exclude past events today) icalBuddy -n -ic "mkane@cloudflare.com" eventsToday
Events in Date Range
bash
icalBuddy -ic "mkane@cloudflare.com" eventsFrom:"2026-01-07" to:"2026-01-14"
Events Happening Now
bash
icalBuddy -ic "mkane@cloudflare.com" eventsNow
Show Event UIDs
bash
icalBuddy -uid -ic "mkane@cloudflare.com" eventsToday
Useful Options
| Option | Description |
|---|---|
-ic "Cal" | Include only this calendar |
-ec "Cal" | Exclude this calendar |
-n | Only events from now on |
-uid | Show event UIDs |
-nc | No calendar names in output |
-eep notes | Exclude notes property |
-eep attendees | Exclude attendees |
-eep notes,attendees | Exclude multiple properties |
-li 5 | Limit to 5 items |
-tf "%H:%M" | Time format (24h) |
-df "%Y-%m-%d" | Date format |
Example Output
code
• Team standup (Work)
location: Zoom
notes: Daily sync
attendees: alice@co.com, bob@co.com
09:00 - 09:30
• 1:1 with Alice (Work)
location: Conference Room B
14:00 - 14:30
Filtering Noisy Calendars
Exclude holidays and birthdays:
bash
icalBuddy -ec "Birthdays,UK Holidays,Siri Suggestions" eventsToday
Or include only work calendar:
bash
icalBuddy -ic "mkane@cloudflare.com" eventsToday
When to Use
- •Morning routine: Check today's events to plan the day
- •Before meetings: Get event details for meeting links and context
- •Scheduling: Check availability before suggesting times
- •End of day: Review what happened, what's tomorrow