calendar_skill

Overview

This skill lets you interact with Apple Calendar on macOS using AppleScript-driven shell helpers. It provides commands to list calendars, query events, create events, and search by keyword, returning TSV, Markdown, or JSON for easy consumption. Use it when you need quick, scriptable access to Calendar.app data and local-only privacy.

How this skill works

The skill runs small shell scripts that invoke AppleScript to read and write Calendar.app data. Scripts include listing calendars, fetching events over date ranges, creating events with optional location and description, and searching events by keyword. Outputs can be produced as TSV, Markdown, or JSON for human reading or programmatic processing.

When to use it

• Check today's, upcoming, or custom-range events quickly
• Find available free time or available slots in your schedule
• Create a new event with title, start/end, calendar, location, and notes
• List and choose among multiple calendars on the Mac
• Search for past or future events by keyword or calendar filter

Best practices

• Always confirm timezone and date format when creating events to avoid mistakes
• Prefer JSON output for automation and TSV/Markdown for human-readable lists
• Filter by calendar (-c) to narrow results and reduce noise
• Do not attempt deletions without explicit confirmation; deletion is not included and must be handled carefully
• Run scripts on the Mac that hosts the Calendar.app; they require macOS and Calendar.app access

Example use cases

• List all calendars as JSON to populate a UI selector
• Get this week’s events in Markdown to paste into a daily briefing email
• Create a meeting event with start/end, location, and description via a quick command
• Search for ‘dentist’ or ‘standup’ across calendars to find past appointments
• Fetch the next 14 days of events as TSV for import into a spreadsheet