calendar

name	calendar
description	Read events from Calendar.app using icalBuddy

Calendar

Read-only access to macOS Calendar.app via icalBuddy.

Prerequisites

brew install ical-buddy

Commands

List Calendars

icalBuddy calendars

Today's Events

# All calendars
icalBuddy eventsToday

# Specific calendar
icalBuddy -ic "[e-mail]" eventsToday

# Compact format (no notes/attendees)
icalBuddy -eep notes,attendees -ic "[e-mail]" eventsToday

Upcoming Events

# Today + next 3 days
icalBuddy -ic "[e-mail]" eventsToday+3

# From now only (exclude past events today)
icalBuddy -n -ic "[e-mail]" eventsToday

Events in Date Range

icalBuddy -ic "[e-mail]" eventsFrom:"2026-01-07" to:"2026-01-14"

Events Happening Now

icalBuddy -ic "[e-mail]" eventsNow

Show Event UIDs

icalBuddy -uid -ic "[e-mail]" 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

• Team standup (Work)
    location: Zoom
    notes: Daily sync
    attendees: [e-mail], [e-mail]
    09:00 - 09:30
• 1:1 with Alice (Work)
    location: Conference Room B
    14:00 - 14:30

Filtering Noisy Calendars

Exclude holidays and birthdays:

icalBuddy -ec "Birthdays,UK Holidays,Siri Suggestions" eventsToday

Or include only work calendar:

icalBuddy -ic "[e-mail]" 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