Apple Calendar

When to use this skill

Use Apple Calendar when an AI agent needs a reusable SKILL.md workflow for this job: Query and manage Apple Calendar on macOS via icalBuddy (read) and AppleScript (osascript) for event creation. Use when users ask about upcoming events, scheduling, calendar lookups, adding calendar events, or checking what's on their agenda. Triggers on mentions of calendar, events, schedule, meetings, or appointments.

When not to use it

Skip Apple Calendar when the task is outside the productivity category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

1. Personal install: create ~/.claude/skills/apple-calendar/SKILL.md (and any bundled scripts) so Claude Code, Claude Desktop, and compatible agents can load it in every project.
2. Project install: commit the same folder at .claude/skills/apple-calendar/ so teammates get the skill with the repo.
3. Restart the agent session after copying files so it re-scans the skills directory, then ask for the task in words that match the skill description.

Full install guide for Claude, Cursor, and Codex

What this skill does

# Apple Calendar

Use this skill for Apple Calendar tasks on macOS.

## Prerequisites

- macOS - Install `icalBuddy` for fast read-only queries:

```bash brew install ical-buddy ```

- `osascript` is built in to macOS for event creation.

## Read events (icalBuddy)

Today's events:

```bash icalBuddy eventsToday ```

Next 7 days:

```bash icalBuddy eventsFrom:today to:7 days from now ```

Specific calendars only:

```bash icalBuddy -ic 'Work,Personal' eventsFrom:today to:3 days from now ```

## Create events (AppleScript)

```bash osascript -e 'tell application "Calendar" to tell calendar "Work" to make new event with properties {summary:"Team Sync", start date:date "Monday, February 10, 2026 10:00:00", end date:date "Monday, February 10, 2026 10:30:00"}' ```

## Usage guidance

- Always include absolute date/time in confirmations. - Use read commands before mutating when user intent is ambiguous. - If automation fails, user likely needs to allow Terminal automation permissions.

Intended uses

• Use Apple Calendar when this documented workflow matches the task.