Macos calendar

Skill lucaperret/agent-skills/skills/macos-calendar

Agent Skills that give AI coding agents superpowers beyond code — macOS native apps, MCP server deployment, and AI connector publishing

Install

npx -y skills add lucaperret/agent-skills --skill macos-calendar

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Create, list, and manage macOS Calendar events via AppleScript. Use when the user asks to add a reminder, schedule an event, create a calendar entry, set a deadline, or anything involving Apple Calendar on macOS. Triggers on requests like "remind me in 3 days", "add to my calendar", "schedule a meeting next Monday at 2pm", "create a recurring weekly event". macOS only.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.4 KB, as published. Nobody here has run it

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

Interpreting natural language

Map user requests to JSON fields:

User says	JSON
"tomorrow at 2pm"	`offset_days: 1, hour: 14`
"in 3 days"	`offset_days: 3`
"next Monday at 10am"	Calculate offset_days from today to next Monday, `hour: 10`
"February 25 at 3:30pm"	`iso_date: "2026-02-25", hour: 15, minute: 30`
"every weekday at 9am"	`hour: 9, recurrence: "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"`
"remind me 1 hour before"	`alarm_minutes: 60`
"all day event on March 1"	`iso_date: "2026-03-01", all_day: true`

For "next Monday", "next Friday" etc: compute the day offset using the current date. Use date command if needed:

# Days until next Monday (1=Monday)
target=1; today=$(date +%u); echo $(( (target - today + 7) % 7 ))

Example prompts

These are real user prompts and the commands you should run:

"Remind me to call the dentist in 2 days"

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

Then:

echo '{"calendar":"Personnel","summary":"Call dentist","offset_days":2,"hour":9,"duration_minutes":15,"alarm_minutes":30}' | "$SKILL_DIR/scripts/calendar.sh" create-event

"Schedule a team sync every Tuesday at 2pm with a 10-min reminder"

echo '{"calendar":"Work","summary":"Team sync","hour":14,"duration_minutes":60,"recurrence":"FREQ=WEEKLY;BYDAY=TU","alarm_minutes":10}' | "$SKILL_DIR/scripts/calendar.sh" create-event

"Block July 15 as a vacation day"

echo '{"calendar":"Personnel","summary":"Vacances","iso_date":"2026-07-15","all_day":true}' | "$SKILL_DIR/scripts/calendar.sh" create-event

"I have a doctor appointment next Thursday at 3:30pm, remind me 1 hour before"

# First compute offset_days to next Thursday (4=Thursday)
target=4; today=$(date +%u); offset=$(( (target - today + 7) % 7 )); [ "$offset" -eq 0 ] && offset=7