read-calendar

Read macOS Calendar events for a specified date range. Use this when the user asks about their schedule, upcoming meetings, today's agenda, or wants to know what's on their calendar. Returns events with times, locations, and attendees.

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 9, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill enables automated retrieval and analysis of macOS Calendar events, providing users with a streamlined way to manage their daily agendas, track upcoming meetings, and identify scheduling conflicts directly through AI interaction. By leveraging the icalBuddy utility, it ensures accurate handling of recurring events and provides comprehensive details including times, locations, and attendee lists.

Use Cases

  • Daily Agenda Briefing: Automatically summarize all scheduled events, locations, and attendees for the day to stay prepared and organized.
  • Meeting Conflict Identification: Analyze the calendar to detect overlapping appointments and highlight gaps for potential focus time or deep work.
  • Availability Analysis: Quickly find open time slots for new appointments or planning sessions within a specified date range using natural language queries.
  • Contextual Schedule Retrieval: Ask specific questions like 'What is my next meeting?' or 'Do I have any meetings tomorrow?' to get instant, formatted responses without opening the Calendar app.
nameread-calendar
descriptionRead macOS Calendar events for a specified date range. Use this when the user asks about their schedule, upcoming meetings, today's agenda, or wants to know what's on their calendar. Returns events with times, locations, and attendees.
allowed-toolsBash

Read Calendar

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: to: ```

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