apple-calendar

Automate Calendar.app CRUD and search operations via AppleScript.

5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/gabrielkoerich/skills --skill apple-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-calendar
Source: https://github.com/gabrielkoerich/skills/tree/main/apple-calendar
Command: npx skills add https://github.com/gabrielkoerich/skills --skill apple-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Apple Calendar app integration for macOS enables programmatic CRUD operations on events across calendars via AppleScript, reducing manual calendar work and enabling automation pipelines.

Core Features & Use Cases

  • Create, read, update, delete, and search events across multiple calendars using shell scripts that call AppleScript.
  • List calendars and events, support all-day events and recurrence, and perform cross-calendar scheduling with simple commands.
  • Use Case: Schedule a weekly standup across calendars and adjust events automatically using the provided scripts.

Quick Start

Install and grant Calendar.app access, then use the included scripts (e.g., cal-create.sh, cal-read.sh) to manage events across calendars.

Frequently Asked Questions about apple-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Apple Calendar event management on macOS?

Automate Apple Calendar event management by executing AppleScript via osascript to perform CRUD and search operations across calendars. This enables programmatic scheduling pipelines, returning structured textual output including event UIDs and details.

Can I create and search Calendar.app events across multiple calendars using shell scripts?

Yes, you can create and search Calendar.app events across multiple calendars using shell scripts that call AppleScript. The scripts support cross-calendar scheduling, all-day events, recurrence, and list both calendars and events.

What date formats does AppleScript automation support for macOS Calendar events?

AppleScript automation for macOS Calendar events parses YYYY-MM-DD and YYYY-MM-DD HH:MM date inputs. This allows precise scheduling and event retrieval when creating or updating calendar entries via shell scripts.

Does macOS Calendar automation handle read-only protections and missing calendars?

Yes, macOS Calendar automation includes robust error handling for missing calendars and read-only protections. This prevents silent failures during cross-calendar event management and ensures script execution stops safely on permission errors.

Do I need to grant permissions to automate Calendar.app interactions on macOS?

Yes, you need to grant Calendar.app access on macOS before automating interactions. Once permissions are configured, the included shell scripts can execute AppleScript to manage events, list calendars, and perform search operations.

What is the best way to schedule a recurring standup across multiple Apple calendars?

The best way to schedule a recurring standup across multiple Apple calendars is using shell scripts that execute AppleScript to programmatically create events. This supports all-day events, recurrence rules, and cross-calendar scheduling.