# Apple Calendar

> 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.

- Skill: `microclaw/apple-calendar` (Agent Skill)
- Install (CLI): `npx skillmds@latest add microclaw/apple-calendar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microclaw/apple-calendar/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: Proprietary. LICENSE.txt has complete terms
- Author: microclaw (https://skillmd.com/u/microclaw)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microclaw/apple-calendar

---


# 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.