read-calendar

Extract macOS Calendar events for a date range using icalBuddy.

12|3|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/ronnycoding/my-personal-assistant --skill read-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-calendar
Source: https://github.com/ronnycoding/my-personal-assistant/tree/main/.claude/skills/read-calendar
Command: npx skills add https://github.com/ronnycoding/my-personal-assistant --skill read-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ical-buddy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manually checking your calendar for upcoming events, especially recurring ones, can be time-consuming and prone to oversight. This Skill provides an instant, clear overview of your macOS Calendar events for any specified date range, helping you stay on top of your schedule effortlessly.

Core Features & Use Cases

  • Comprehensive Event Retrieval: Fetches all calendar events, including complex recurring events, for a given day or week, ensuring you have a complete picture of your commitments.
  • Clear Schedule Overview: Presents events with times, titles, and locations in an easy-to-read format, making it simple to understand your daily or weekly agenda.
  • Use Case: Ask "What's on my calendar today?" and immediately see your full daily agenda, allowing you to quickly prepare for meetings, identify blocks of free time, or plan your day with confidence.

Quick Start

Show me my schedule for tomorrow.

Frequently Asked Questions about read-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get my calendar events for a specific date range on macOS?

Extract calendar events by specifying a date range to retrieve all events, including recurring ones, from macOS Calendar. The Skill fetches events with times, locations, and attendees, then groups them by day in a structured list so you can see your full schedule instantly.

Can I see recurring events and conflicts in my schedule?

Yes, the Skill uses icalBuddy to fetch recurring events and identifies scheduling conflicts automatically. It displays events with their times and locations grouped by day, highlighting overlaps so you can spot conflicts and plan around them.

What's the best way to get a clear overview of my weekly schedule?

Request your calendar for a week-long date range to see all events organized by day with times, titles, locations, and calendar names. The Skill also identifies gaps in your schedule, helping you spot available focus time blocks.

Do I need any tools installed to access my macOS Calendar events?

Yes, the Skill requires icalBuddy as a dependency to fetch calendar data from macOS Calendar. icalBuddy retrieves recurring events and structured event details, enabling the Skill to present your complete schedule.

How do I quickly check what meetings I have today?

Ask the Skill for today's calendar events to instantly see your full daily agenda with meeting times, titles, and locations. This lets you prepare for upcoming meetings and identify blocks of free time for focused work.