Retrieves calendar events from macOS Calendar for analysis, planning, and scheduling.
When to Use
- "What's on my calendar today?"
- "Show me my schedule for this week"
- "Do I have any meetings tomorrow?"
- "What's my next meeting?"
Requirements
This skill requires icalBuddy to properly handle recurring events:
```bash
brew install ical-buddy
```
Instructions
Execute Calendar Read
Use icalBuddy to retrieve events including recurring ones:
```bash icalBuddy -n -iep "title,datetime,location" -df "%Y-%m-%d" -tf "%H:%M" eventsFrom:<start_date> to:<end_date> ```
Example: ```bash icalBuddy -n -iep "title,datetime,location" -df "%Y-%m-%d" -tf "%H:%M" eventsFrom:2025-10-26 to:2025-10-27 ```
Note: icalBuddy properly handles recurring events (unlike AppleScript which doesn't pre-generate future instances).
Present Results
Format events clearly:
- Group by day
- Show time, title, location, calendar name
- Highlight conflicts if any
- Identify gaps for focus time
- Mark recurring events clearly