Macos Calendar

This is a native macOS Calendar integration that lets Claude schedule events, set reminders, and create recurring meetings through AppleScript. It handles the tricky bits like natural language date parsing ("next Monday at 2pm"), calendar selection, and recurrence rules without hitting locale formatting issues. The JSON-based interface is clean and the skill correctly guards against read-only calendars. Worth noting that it requires you to list calendars first before creating events, which is the right approach but adds a step. If you're on macOS and want Claude to actually modify your calendar instead of just suggesting events, this does the job. Works best when you're specific about times and calendar names.

skills.sh installs: 345
GitHub stars: 7
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add lucaperret/agent-skills --skill macos-calendar --agent claude-code

Installs into .claude/skills of the current project.

Files

macOS Calendar

Manage Apple Calendar events via $SKILL_DIR/scripts/calendar.sh. All date handling uses relative math (current date + N * days) to avoid locale issues (FR/EN/DE date formats).

Quick start

List calendars

Always list calendars first to find the correct calendar name:

"$SKILL_DIR/scripts/calendar.sh" list-calendars

Create an event

echo '<json>' | "$SKILL_DIR/scripts/calendar.sh" create-event

JSON fields:

Field	Required	Default	Description
`summary`	yes	-	Event title
`calendar`	no	first calendar	Calendar name (from list-calendars)
`description`	no	""	Event notes
`offset_days`	no	0	Days from today (0=today, 1=tomorrow, 7=next week)
`iso_date`	no	-	Absolute date `YYYY-MM-DD` (overrides offset_days)
`hour`	no	9	Start hour (0-23)
`minute`	no	0	Start minute (0-59)
`duration_minutes`	no	30	Duration
`alarm_minutes`	no	0	Alert N minutes before (0=no alarm)
`all_day`	no	false	All-day event
`recurrence`	no	-	iCal RRULE string. See references/recurrence.md