calendar-operator

Manage Apple Calendar events, check availability, and perform dry-run deletions.

Updated May 22, 2026
One-click install
npx skills add https://github.com/Agentic-Assets/apple-mail-mcp --skill calendar-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calendar-operator
Source: https://github.com/Agentic-Assets/apple-mail-mcp/tree/main/plugin/skills/calendar-operator
Command: npx skills add https://github.com/Agentic-Assets/apple-mail-mcp --skill calendar-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires applescript, eventkit, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies managing your Apple Calendar, handling tasks like scheduling, availability checks, and calendar cleanup.

Core Features & Use Cases

  • Event Management: Add, edit, and delete events with precision, including handling recurring events.
  • Availability Check: Check your availability for scheduled events, with options for narrowing down by date or calendar.
  • Calendar Cleanup: Perform dry-run deletions and manage calendars safely.
  • Use Case: Need to check your calendar availability for a meeting on Thursday or add a new event. Use this Skill to efficiently manage your calendar and ensure everything is in order.

Quick Start

List all your calendars with list_calendars().

Frequently Asked Questions about calendar-operator

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

FAQPage Schema
How do I manage Apple Calendar events using an automated assistant?

Managing Apple Calendar events is handled by reading, writing, and deleting entries through AppleScript or EventKit. You can automate scheduling, availability checks, and recurring event updates directly without manual interface interaction.

Can I check calendar availability for a specific date using AppleScript?

Yes, checking calendar availability for specific dates is supported through AppleScript operations. You can query scheduled events and narrow down results by date or specific calendar to determine open time slots.

Do I need macOS to run EventKit calendar operations?

Yes, macOS is required to run EventKit and AppleScript calendar operations. These dependencies rely on native macOS frameworks to access Apple Calendar data for scheduling and event management tasks.

What is the safest way to delete recurring events in Apple Calendar?

Deleting recurring events safely is supported through dry-run deletions. This approach allows you to preview which calendar events will be removed before committing to permanent deletion, preventing accidental data loss.

How do I create and update calendar events programmatically?

Creating and updating calendar events programmatically involves writing event data via AppleScript or EventKit operations. You can add new events, modify existing schedules, and handle recurring entries with precise calendar management functions.

Are there limitations when using AppleScript for calendar cleanup?

Calendar cleanup via AppleScript focuses on safe operations like dry-run deletions to prevent errors. Limitations include dependency on macOS and native frameworks, meaning it cannot run on non-Apple environments.