---

name: calendar description: Read events from Calendar.app using icalBuddy

Calendar

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

Prerequisites

Copybrew install ical-buddy

Commands

List Calendars

CopyicalBuddy calendars

Today's Events

Copy# 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

Copy# 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

CopyicalBuddy -ic "mkane@cloudflare.com" eventsFrom:"2026-01-07" to:"2026-01-14"

Events Happening Now

CopyicalBuddy -ic "mkane@cloudflare.com" eventsNow

Show Event UIDs

CopyicalBuddy -uid -ic "mkane@cloudflare.com" eventsToday

Useful Options

Example Output

Copy• 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:

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

Or include only work calendar:

CopyicalBuddy -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