apple-calendar — Claude Code skill: what it does, how to install
This skill connects an AI agent to Calendar.app on macOS for event search, lookup, creation, editing, deletion, and work across multiple calendars.
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a claude-codeWhat apple-calendar does
apple-calendar uses AppleScript to work with Calendar.app and runs its scripts from cd {baseDir}. It can list calendars and events, fetch full event details by UID, search by text, create records, update selected fields, and remove events. Event creation supports timed and all-day dates, location, description, and recurrence.
Event and search output includes the UID, summary, start and end, all-day state, location, and calendar. Calendar names are case-sensitive. Birthdays and Holidays are read-only calendars, while deleting a recurring event removes the whole series, so the calendar and UID should be checked before that operation.
What it helps with
- list calendars and upcoming events
- search events by a text query
- create a meeting with recurrence
- change an event’s time or description
- read full details from an event UID
Example prompts for the agent
- Show events for the next 7 days in the
Workcalendar. - Create an event in
Worknamed “Demo”, from2025-04-10 14:00to2025-04-10 15:00. - Search for events containing “report” and return their UIDs.
How to install apple-calendar
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a claude-code2Manually: put the files in place
~/.claude/skills/apple-calendar/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apple-calendar/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a codex2Manually: put the files in place
.agents/skills/apple-calendar/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a cursor2Manually: put the files in place
.cursor/skills/apple-calendar/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sundial-org/awesome-openclaw-skills apple-calendar2Manually: put the files in place
.github/skills/apple-calendar/SKILL.md1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a gemini-cli2Platform CLI
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path skills/apple-calendarManually: put the files in place
.devin/skills/apple-calendar/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about apple-calendar
How do I install apple-calendar in Claude Code?
Run npx skills add sundial-org/awesome-openclaw-skills --skill apple-calendar -a claude-code, then use ~/.claude/skills/apple-calendar/SKILL.md.
What does apple-calendar do?
It controls Calendar.app on macOS through AppleScript. The skill can list, search, read, create, update, and delete calendar events.
What limitations does apple-calendar have?
Calendar names are case-sensitive. Birthdays and Holidays cannot be edited, and removing a recurring event deletes the entire series.