Automating Calendar

Automating Calendar (JXA with AppleScript Discovery)

Contents

• Relationship to the macOS automation skill
• Core Framing
• Workflow (default)
• Core Examples
• What to load

Relationship to the macOS automation skill

• Use automating-mac-apps for general app permissions, shell commands, UI scripting, and cross-app automation patterns.
• This skill focuses specifically on Calendar events, calendars, and EventKit bridge functionality.
• PyXA Installation: To use PyXA examples in this skill, see the installation instructions in automating-mac-apps skill (PyXA Installation section).

Core Framing

• Calendar dictionary is AppleScript-first; discover there
• JXA provides logic, data handling, and ObjC/EventKit bridge access
• PyXA offers modern Python alternative with cleaner syntax

Implementation Notes: See automating-calendar/references/calendar-basics.md

Workflow (default)

1) [ ] Discover Calendar dictionary terms in Script Editor. 2) [ ] Prototype minimal AppleScript commands. 3) [ ] Port to JXA with defensive error handling. 4) [ ] Implemented batch reads (avoided heavy .whose()). 5) [ ] Added EventKit bridge for advanced queries. 6) [ ] Tested with sample events and verified results.

Error Handling

• Wrap operations in try-catch blocks
• Verify calendar access: Calendar.calendars.length > 0
• Check event creation: if (!event.id()) throw new Error('Event creation failed')
• Log operations for debugging

Validation Checklist

• [ ] Calendar permissions granted (System Settings > Privacy & Security > Calendars)
• [ ] Calendar access confirmed: Calendar.calendars.length > 0
• [ ] Event created with valid start/end dates
• [ ] Event visible in Calendar UI after save
• [ ] EventKit bridge queries return expected results
• [ ] Error handling wraps all operations
• [ ] Output matches expected event properties

Core Examples

Basic Event Creation (JXA - Legacy):

const Calendar = Application("Calendar");
const event = Calendar.calendars[0].events.push(Calendar.Event({
  summary: "Meeting",
  startDate: new Date(),
  endDate: new Date(Date.now() + 3600000)
}));

Basic Event Creation (PyXA - Recommended):

import PyXA
from datetime import datetime, timedelta

calendar = PyXA.Calendar()

# Get first calendar
work_calendar = calendar.calendars()[0]

# Create event
event = work_calendar.events().push({
    "summary": "Meeting",
    "start_date": datetime.now(),
    "end_date": datetime.now() + timedelta(hours=1),
    "location": "Conference Room A"
})

print(f"Created event: {event.summary()}")

PyObjC with EventKit (Advanced):

from EventKit import EKEventStore, EKEvent, EKCalendar
from Foundation import NSDate, NSTimeInterval
import objc

# Initialize event store
store = EKEventStore.alloc().init()

# Request access (async in real implementation)
# store.requestAccessToEntityType_completion_(EKEntityTypeEvent, None)

# Get default calendar
calendars = store.calendarsForEntityType_(EKEntityTypeEvent)
if calendars:
    default_calendar = calendars[0]

    # Create event
    event = EKEvent.eventWithEventStore_(store)
    event.setTitle_("Meeting")
    event.setStartDate_(NSDate.date())
    event.setEndDate_(NSDate.dateWithTimeIntervalSinceNow_(3600))  # 1 hour
    event.setCalendar_(default_calendar)

    # Save event
    error = objc.nil
    success = store.saveEvent_span_error_(event, EKSpanThisEvent, error)

    if success:
        print(f"Event created: {event.title()}")
    else:
        print(f"Error creating event: {error}")

EventKit Bridge Query (JXA - Legacy):

ObjC.import('EventKit');
const store = $.EKEventStore.alloc.init;
// See 'eventkit-query.md' for full predicate implementation

EventKit Bridge Query (PyObjC - Modern):

from EventKit import EKEventStore, EKEntityTypeEvent, NSPredicate
from Foundation import NSDate

store = EKEventStore.alloc().init()

# Get events for today
start_date = NSDate.date()  # Today
end_date = NSDate.dateWithTimeIntervalSinceNow_(86400)  # Tomorrow

calendars = store.calendarsForEntityType_(EKEntityTypeEvent)
predicate = store.predicateForEventsWithStartDate_endDate_calendars_(
    start_date, end_date, calendars)

events = store.eventsMatchingPredicate_(predicate)

for event in events:
    print(f"Event: {event.title()}, Start: {event.startDate()}")

When Not to Use

• Cross-platform calendar automation (use Google Calendar API or CalDAV)
• iCloud sync operations (use EventKit directly)
• Non-macOS platforms
• Simple AppleScript-only tasks (skip JXA complexity)
• Calendar sharing or permissions management (use Calendar UI)

What to load

• Calendar JXA basics: automating-calendar/references/calendar-basics.md
• Recipes (events, alarms, recurrence): automating-calendar/references/calendar-recipes.md
• Advanced patterns (time zones, batch reads, EventKit bridge): automating-calendar/references/calendar-advanced.md
• Dictionary translation table: automating-calendar/references/calendar-dictionary.md
• PyXA API Reference (complete class/method docs): automating-calendar/references/calendar-pyxa-api-reference.md
• EventKit query example: automating-calendar/references/eventkit-query.md
• EventKit create with recurrence: automating-calendar/references/eventkit-create.md
• EventKit time zone example: automating-calendar/references/eventkit-timezones.md
• EventKit exceptions/occurrences: automating-calendar/references/eventkit-exceptions.md
• EventKit cancel occurrence example: automating-calendar/references/eventkit-occurrence-cancel.md

Calendar JXA advanced patterns

Batch read warnings

• Avoid heavy .whose() on events; it is slow/unreliable.
• Prefer EventKit bridge for large queries.

Time zones

• JS Date is local; to target another TZ, adjust offset manually or use EventKit.

EventKit bridge (outline)

ObjC.import('EventKit');
const store = $.EKEventStore.alloc.init;
// Request access and wait
// Build predicate and fetch events via eventsMatchingPredicate

UI scripting (view changes)

const se = Application("System Events");
const calProc = se.processes.byName("Calendar");
calProc.menuBars.menuBarItems.byName("View").menus.menuItems.byName("Day").click();

Calendar JXA basics

Bootstrapping

const App = Application.currentApplication();
App.includeStandardAdditions = true;
const Cal = Application("Calendar");

List calendars

const names = Cal.calendars.name();

Create simple event

const cal = Cal.calendars.byName("Work");
const start = new Date();
const end = new Date(start.getTime() + 60 * 60000);
cal.events.push(Cal.Event({ summary: "Meeting", startDate: start, endDate: end }));

Calendar dictionary translation table

AppleScript                         JXA
----------------------------------- ------------------------------------------
calendar "Work"                    Cal.calendars.byName("Work")
events of calendar                 Cal.calendars.events
summary of event                   evt.summary()
start date of event                evt.startDate()
make new event                     cal.events.push(Cal.Event({...}))

Notes:

• Collections are specifiers; call methods to read values.
• Use recurrence strings for RRULEs.

PyXA Calendar Module API Reference

PyXA Module - Control macOS Calendar.app using JXA-like syntax from Python.

This reference documents all classes, methods, properties, and enums in the PyXA Calendar module. For practical examples and usage patterns, see calendar-basics.md and calendar-recipes.md.

Contents

• Class Hierarchy
• XACalendarApplication
• XACalendarCalendar
• XACalendarEvent
• XACalendarAttendee
• XACalendarAttachment
• XACalendarAlarm
• XACalendarDocument
• XACalendarWindow
• List Classes
• Enumerations
• Quick Reference Tables

---

Class Hierarchy

XAObject
├── XACalendarApplication (XASBApplication, XACanOpenPath)
│   ├── XACalendarCalendar
│   │   └── XACalendarEvent
│   │       ├── XACalendarAttendee
│   │       └── XACalendarAttachment
│   ├── XACalendarDocument
│   └── XACalendarWindow (XASBWindow)
├── XACalendarAlarm
│   ├── XACalendarDisplayAlarm
│   ├── XACalendarMailAlarm
│   ├── XACalendarOpenFileAlarm
│   └── XACalendarSoundAlarm
└── List Classes
    ├── XACalendarCalendarList
    ├── XACalendarEventList
    ├── XACalendarAttendeeList
    ├── XACalendarAttachmentList
    └── XACalendarDocumentList

---

XACalendarApplication

Bases: XASBApplication, XACanOpenPath

Main entry point for interacting with Calendar.app.

Properties

Methods

calendars(filter=None) -> XACalendarCalendarList

Returns a list of calendars matching the filter.

Parameters:

• filter (dict | None) - Property-value pairs to filter by

Example:

import PyXA
calendar = PyXA.Application("Calendar")
calendars = calendar.calendars()
for cal in calendars:
    print(cal.name)

documents(filter=None) -> XACalendarDocumentList

Returns a list of open documents matching the filter.

Parameters:

• filter (dict | None) - Property-value pairs to filter by

new_calendar(name='New Calendar') -> XACalendarCalendar

Creates a new calendar with the specified name.

Parameters:

• name (str) - Name for the new calendar (default: "New Calendar")

Returns: The newly created calendar

Example:

calendar = PyXA.Application("Calendar")
work_cal = calendar.new_calendar("Work Events")
print(f"Created: {work_cal.name}")

new_event(summary, start_date, end_date, calendar=None) -> XACalendarEvent

Creates a new event.

Parameters:

• summary (str) - Event title/summary
• start_date (datetime) - Event start time
• end_date (datetime) - Event end time
• calendar (XACalendarCalendar | None) - Calendar to add event to (default: default calendar)

Returns: The newly created event

Example:

from datetime import datetime, timedelta

calendar = PyXA.Application("Calendar")
event = calendar.new_event(
    summary="Team Meeting",
    start_date=datetime.now(),
    end_date=datetime.now() + timedelta(hours=1)
)
print(f"Created event: {event.summary}")

make(specifier, properties=None, data=None) -> XAObject

Creates a new element without adding to any list. Use XAList.push() to add.

Parameters:

• specifier (str | ObjectType) - Class name to create
• properties (dict) - Properties for the object
• data (Any) - Initialization data

reload_calendars() -> XACalendarApplication

Reloads calendars from all sources. Returns self for chaining.

subscribe_to(url) -> XACalendarCalendar

Subscribes to a calendar at the specified URL.

Parameters:

• url (str) - URL of the calendar to subscribe to (iCal format)

Returns: The subscribed calendar

Example:

calendar = PyXA.Application("Calendar")
subscribed = calendar.subscribe_to("https://example.com/calendar.ics")

switch_view_to(view) -> XACalendarApplication

Switches the calendar view.

Parameters:

• view (ViewType) - View to switch to (DAY, WEEK, MONTH, YEAR)

Returns: Self for method chaining

Example:

calendar = PyXA.Application("Calendar")
calendar.switch_view_to(XACalendarApplication.ViewType.WEEK)

view_calendar_at(date, view=None) -> XACalendarApplication

Navigates to a specific date, optionally changing view.

Parameters:

• date (datetime) - Date to navigate to
• view (ViewType | None) - Optional view to switch to

Returns: Self for method chaining

Example:

from datetime import datetime

calendar = PyXA.Application("Calendar")
# View January 1st in month view
calendar.view_calendar_at(
    datetime(2025, 1, 1),
    XACalendarApplication.ViewType.MONTH
)

---

XACalendarCalendar

Bases: XAObject

Represents a calendar in Calendar.app.

Properties

Methods

events(filter=None) -> XACalendarEventList

Returns events in this calendar matching the filter.

Parameters:

• filter (dict | None) - Property-value pairs to filter by

Example:

calendar = PyXA.Application("Calendar")
work_cal = calendar.calendars().by_name("Work")
all_events = work_cal.events()

events_in_range(start_date, end_date) -> XACalendarEventList

Returns events within a date range.

Parameters:

• start_date (datetime) - Range start
• end_date (datetime) - Range end

Example:

from datetime import datetime, timedelta

calendar = PyXA.Application("Calendar")
cal = calendar.calendars()[0]

# Get events for next week
start = datetime.now()
end = start + timedelta(days=7)
events = cal.events_in_range(start, end)

for event in events:
    print(f"{event.summary}: {event.start_date}")

events_today() -> XACalendarEventList

Returns all events occurring today.

Example:

calendar = PyXA.Application("Calendar")
cal = calendar.calendars()[0]
today_events = cal.events_today()
print(f"You have {len(today_events)} events today")

new_event(name, start_date, end_date) -> XACalendarEvent

Creates a new event in this calendar.

Parameters:

• name (str) - Event title
• start_date (datetime) - Event start time
• end_date (datetime) - Event end time

Returns: The newly created event

Example:

from datetime import datetime, timedelta

calendar = PyXA.Application("Calendar")
work_cal = calendar.calendars().by_name("Work")

event = work_cal.new_event(
    "Project Review",
    datetime(2025, 1, 15, 14, 0),
    datetime(2025, 1, 15, 15, 0)
)

delete() -> XACalendarEvent

Deletes this calendar.

---

XACalendarEvent

Bases: XAObject

Represents a calendar event.

Properties

Methods

attendees(filter=None) -> XACalendarAttendeeList

Returns attendees for this event.

Parameters:

• filter (dict | None) - Property-value pairs to filter by

Example:

calendar = PyXA.Application("Calendar")
event = calendar.calendars()[0].events()[0]
attendees = event.attendees()
for attendee in attendees:
    print(f"{attendee.display_name}: {attendee.email}")

attachments(filter=None) -> XACalendarAttachmentList

Returns attachments for this event.

Parameters:

• filter (dict | None) - Property-value pairs to filter by

add_attachment(path) -> XACalendarEvent

Adds an attachment to this event.

Parameters:

• path (str) - Path to the file to attach

Returns: Self for method chaining

Example:

event = calendar.calendars()[0].events()[0]
event.add_attachment("/Users/me/Documents/agenda.pdf")

delete() -> None

Deletes this event.

duplicate() -> XACalendarEvent

Creates a copy of this event in the same calendar.

Returns: The duplicated event

duplicate_to(calendar) -> XACalendarEvent

Duplicates this event to another calendar.

Parameters:

• calendar (XACalendarCalendar) - Target calendar

Returns: The duplicated event

Example:

calendar = PyXA.Application("Calendar")
work_cal = calendar.calendars().by_name("Work")
personal_cal = calendar.calendars().by_name("Personal")

# Copy event to personal calendar
event = work_cal.events()[0]
copied = event.duplicate_to(personal_cal)

move_to(calendar) -> XACalendarEvent

Moves this event to another calendar.

Parameters:

• calendar (XACalendarCalendar) - Target calendar

Returns: Self for method chaining

show() -> XACalendarEvent

Opens the event in Calendar.app for viewing.

Returns: Self for method chaining

---

XACalendarAttendee

Bases: XAObject

Represents an event attendee.

Properties

---

XACalendarAttachment

Bases: XAObject

Represents an event attachment.

Properties

Methods

open() -> XACalendarAttachment

Opens the attachment in its default application.

Returns: Self for method chaining

---

XACalendarAlarm

Bases: XAObject

Base class for all alarm types.

Properties

XACalendarDisplayAlarm

Bases: XACalendarAlarm

A visual notification alarm.

XACalendarMailAlarm

Bases: XACalendarAlarm

An email notification alarm.

XACalendarOpenFileAlarm

Bases: XACalendarAlarm

An alarm that opens a file.

Additional Properties:

XACalendarSoundAlarm

Bases: XACalendarAlarm

An alarm that plays a sound.

Additional Properties:

---

XACalendarDocument

Bases: XAObject

Represents a Calendar document.

Properties

---

XACalendarWindow

Bases: XASBWindow

Represents a Calendar window.

Properties

---

List Classes

PyXA provides list wrapper classes with fast enumeration and bulk property access.

XACalendarCalendarList

Bulk methods for calendar lists:

calendars = app.calendars()
calendars.name()          # -> list[str]
calendars.description()   # -> list[str]
calendars.color()         # -> list[XAColor]
calendars.writable()      # -> list[bool]
calendars.properties()    # -> list[dict]

Filter methods:

calendars.by_name("Work")
calendars.by_writable(True)
calendars.by_description("Personal calendar")

XACalendarEventList

Bulk methods for event lists:

events = calendar.events()
events.summary()          # -> list[str]
events.description()      # -> list[str]
events.start_date()       # -> list[datetime]
events.end_date()         # -> list[datetime]
events.allday_event()     # -> list[bool]
events.location()         # -> list[str]
events.url()              # -> list[str]
events.recurrence()       # -> list[str]
events.status()           # -> list[EventStatus]
events.uid()              # -> list[str]
events.properties()       # -> list[dict]

Filter methods:

events.by_summary("Meeting")
events.by_location("Conference Room")
events.by_allday_event(True)
events.by_status(XACalendarApplication.EventStatus.CONFIRMED)

XACalendarAttendeeList

Bulk methods for attendee lists:

attendees = event.attendees()
attendees.display_name()          # -> list[str]
attendees.email()                 # -> list[str]
attendees.participation_status()  # -> list[ParticipationStatus]
attendees.properties()            # -> list[dict]

Filter methods:

attendees.by_email("user@example.com")
attendees.by_display_name("John Doe")
attendees.by_participation_status(XACalendarApplication.ParticipationStatus.ACCEPTED)

XACalendarAttachmentList

Bulk methods for attachment lists:

attachments = event.attachments()
attachments.file_name()    # -> list[str]
attachments.type()         # -> list[str]
attachments.uuid()         # -> list[str]
attachments.properties()   # -> list[dict]

Filter methods:

attachments.by_file_name("document.pdf")
attachments.by_type("application/pdf")

XACalendarDocumentList

Bulk methods for document lists:

docs = app.documents()
docs.name()        # -> list[str]
docs.modified()    # -> list[bool]
docs.file()        # -> list[XAPath]
docs.properties()  # -> list[dict]

Filter methods:

docs.by_name("Calendar")
docs.by_modified(True)

---

Enumerations

EventStatus

Event confirmation status.

Usage:

from PyXA import XACalendarApplication

# Filter confirmed events
confirmed = events.by_status(XACalendarApplication.EventStatus.CONFIRMED)

# Check event status
if event.status == XACalendarApplication.EventStatus.CANCELLED:
    print("Event was cancelled")

ParticipationStatus

Attendee RSVP status.

Usage:

# Get accepted attendees
accepted = attendees.by_participation_status(
    XACalendarApplication.ParticipationStatus.ACCEPTED
)

Priority

Event priority levels.

ViewType

Calendar view options.

Usage:

# Switch to week view
calendar.switch_view_to(XACalendarApplication.ViewType.WEEK)

# Navigate to specific date in month view
calendar.view_calendar_at(
    datetime(2025, 6, 1),
    XACalendarApplication.ViewType.MONTH
)

ObjectType

Creatable object types for the make() method.

Usage:

# Create an event using make()
event = calendar.make(
    XACalendarApplication.ObjectType.EVENT,
    properties={
        "summary": "New Meeting",
        "start_date": datetime.now(),
        "end_date": datetime.now() + timedelta(hours=1)
    }
)

---

Quick Reference Tables

Common Operations

Property Access Patterns

# Single object property access
event = cal.events()[0]
print(event.summary)
print(event.start_date)
print(event.location)

# Bulk access on lists (returns list)
events = cal.events()
print(events.summary())      # -> list[str]
print(events.start_date())   # -> list[datetime]
print(events.location())     # -> list[str]

# Filtering
meetings = events.by_summary("Meeting")
all_day = events.by_allday_event(True)

Date Range Queries

from datetime import datetime, timedelta

# Today's events
today = cal.events_today()

# This week
start = datetime.now()
end = start + timedelta(days=7)
this_week = cal.events_in_range(start, end)

# Specific month
jan_start = datetime(2025, 1, 1)
jan_end = datetime(2025, 1, 31, 23, 59, 59)
january_events = cal.events_in_range(jan_start, jan_end)

Creating Events with Properties

from datetime import datetime, timedelta

# Basic event
event = cal.new_event(
    "Team Standup",
    datetime(2025, 1, 15, 9, 0),
    datetime(2025, 1, 15, 9, 30)
)

# Event via application with calendar selection
event = calendar.new_event(
    summary="Quarterly Review",
    start_date=datetime(2025, 3, 15, 14, 0),
    end_date=datetime(2025, 3, 15, 16, 0),
    calendar=calendar.calendars().by_name("Work")
)

---

See Also

• PyXA Calendar Documentation - Official PyXA documentation
• calendar-basics.md - JXA fundamentals for Calendar
• calendar-recipes.md - Common automation patterns
• calendar-advanced.md - EventKit bridge and advanced patterns
• eventkit-query.md - EventKit query examples

Calendar JXA recipes

Create recurring event

const cal = Cal.calendars.byName("Work");
const start = new Date();
const end = new Date(start.getTime() + 30 * 60000);
cal.events.push(Cal.Event({
  summary: "Daily standup",
  startDate: start,
  endDate: end,
  recurrence: "FREQ=DAILY;INTERVAL=1"
}));

Add alarm

const evt = cal.events[0];
const alarm = Cal.DisplayAlarm({ triggerInterval: -900 }); // 15 min
evt.displayAlarms.push(alarm);

Add multiple alerts (1d, 1h, 15m)

const evt = cal.events[0];
evt.displayAlarms.push(Cal.DisplayAlarm({ triggerInterval: -86400 })); // 1 day
evt.displayAlarms.push(Cal.DisplayAlarm({ triggerInterval: -3600 }));  // 1 hour
evt.displayAlarms.push(Cal.DisplayAlarm({ triggerInterval: -900 }));   // 15 min

Move event (delete + recreate pattern)

const evt = cal.events[0];
const props = {
  summary: evt.summary(),
  startDate: new Date(Date.now() + 3600 * 1000),
  endDate: new Date(Date.now() + 7200 * 1000)
};
cal.events.push(Cal.Event(props));
evt.delete();

EventKit create event with recurrence (JXA + ObjC)

ObjC.import('EventKit');
ObjC.import('Foundation');

const store = $.EKEventStore.alloc.init;
let granted = false;
const g = $.dispatch_group_create();
$.dispatch_group_enter(g);
store.requestAccessToEntityTypeCompletion($.EKEntityTypeEvent, (ok, err) => {
  granted = ok;
  $.dispatch_group_leave(g);
});
$.dispatch_group_wait(g, $.DISPATCH_TIME_FOREVER);
if (!granted) throw new Error("Calendar access denied");

// Find calendar
const cals = store.calendarsForEntityType($.EKEntityTypeEvent);
let target = null;
for (let i = 0; i < cals.count; i++) {
  const c = cals.objectAtIndex(i);
  if (c.title.js === "Work") { target = c; break; }
}
if (!target) throw new Error("Calendar 'Work' not found");

// Create event
const evt = $.EKEvent.eventWithEventStore(store);
evt.title = "JXA EventKit";
evt.startDate = $.NSDate.dateWithTimeIntervalSinceNow(3600);
evt.endDate = $.NSDate.dateWithTimeIntervalSinceNow(7200);
evt.calendar = target;

// Recurrence: weekly on Mon/Fri
const mon = $.EKRecurrenceDayOfWeek.dayOfWeek(2);
const fri = $.EKRecurrenceDayOfWeek.dayOfWeek(6);
const rule = $.EKRecurrenceRule.alloc.initRecurrenceWithFrequencyIntervalDaysOfTheWeekDaysOfTheMonthMonthsOfTheYearWeeksOfTheYearDaysOfTheYearSetPositionsEnd(
  $.EKRecurrenceFrequencyWeekly,
  1,
  [mon, fri],
  $.nil, $.nil, $.nil, $.nil, $.nil,
  $.nil
);
evt.addRecurrenceRule(rule);

const err = $();
const ok = store.saveEventSpanCommitError(evt, $.EKSpanThisEvent, true, err);
if (!ok) console.log("Save failed: " + err.localizedDescription.js);

EventKit exceptions and occurrences (notes)

Modify a single occurrence

// Given an eventIdentifier for a recurring event
const id = "<event-id>";
const master = store.eventWithIdentifier(id);

// Fetch occurrence on a specific date
const cal = $.NSCalendar.currentCalendar;
const comps = cal.componentsFromDate($.NSCalendarUnitYear | $.NSCalendarUnitMonth | $.NSCalendarUnitDay, master.startDate);
// adjust comps to target occurrence date
// build date for that occurrence window, then:
const occ = store.eventWithIdentifier(master.eventIdentifier).copy();
// In practice, use eventStore.eventsMatchingPredicate with date window to get the occurrence
// Then modify and save with EKSpanFutureEvents or EKSpanThisEvent

Cancel a single occurrence

• Find the occurrence (via predicate around that date) and use store.removeEventSpanCommitError(occ, $.EKSpanThisEvent, true, err).

Notes:

• EventKit requires precise date windows to fetch individual occurrences.
• For complex exception sets, enumerate occurrences via predicate and modify/remove selectively.

EventKit: cancel a single occurrence

ObjC.import('EventKit');
ObjC.import('Foundation');

const store = $.EKEventStore.alloc.init;
let granted = false;
const g = $.dispatch_group_create();
$.dispatch_group_enter(g);
store.requestAccessToEntityTypeCompletion($.EKEntityTypeEvent, (ok, err) => { granted = ok; $.dispatch_group_leave(g); });
$.dispatch_group_wait(g, $.DISPATCH_TIME_FOREVER);
if (!granted) throw new Error("Calendar access denied");

function findCalendar(title) {
  const cals = store.calendarsForEntityType($.EKEntityTypeEvent);
  for (let i = 0; i < cals.count; i++) {
    const c = cals.objectAtIndex(i);
    if (c.title.js === title) return c;
  }
  return null;
}

const targetCal = findCalendar("Work");
if (!targetCal) throw new Error("Calendar not found");

// Define the date window around the occurrence you want to cancel
const cal = $.NSCalendar.currentCalendar;
const startWindow = $.NSDate.dateWithTimeIntervalSinceNow(0); // now
const endWindow = $.NSDate.dateWithTimeIntervalSinceNow(7 * 24 * 3600); // next 7 days

const predicate = store.predicateForEventsWithStartDateEndDateCalendars(startWindow, endWindow, [targetCal]);
const events = store.eventsMatchingPredicate(predicate);

// Find the occurrence by title and date match
let targetOcc = null;
for (let i = 0; i < events.count; i++) {
  const e = events.objectAtIndex(i);
  if (e.title.js === "Weekly Sync" && e.startDate.timeIntervalSinceNow() > 0) {
    targetOcc = e; break;
  }
}

if (targetOcc) {
  const err = $();
  const ok = store.removeEventSpanCommitError(targetOcc, $.EKSpanThisEvent, true, err);
  if (!ok) console.log("Remove failed: " + err.localizedDescription.js);
}

Notes:

• The occurrence is identified by title and date window; refine matching as needed.
• EKSpanThisEvent removes only this occurrence; the series remains.

EventKit query example (JXA + ObjC)

ObjC.import('EventKit');
ObjC.import('Foundation');

const store = $.EKEventStore.alloc.init;
let granted = false;
const group = $.dispatch_group_create();
$.dispatch_group_enter(group);
store.requestAccessToEntityTypeCompletion($.EKEntityTypeEvent, (ok, err) => {
  granted = ok;
  $.dispatch_group_leave(group);
});
$.dispatch_group_wait(group, $.DISPATCH_TIME_FOREVER);
if (!granted) throw new Error("Calendar access denied");

// Date range
const now = $.NSDate.date;
const end = $.NSDate.dateWithTimeIntervalSinceNow(30 * 24 * 3600);

// Pick calendar by title
const cals = store.calendarsForEntityType($.EKEntityTypeEvent);
let target = null;
for (let i = 0; i < cals.count; i++) {
  const c = cals.objectAtIndex(i);
  if (c.title.js === "Work") { target = c; break; }
}
if (!target) throw new Error("Calendar 'Work' not found");

// Predicate + fetch
const predicate = store.predicateForEventsWithStartDateEndDateCalendars(now, end, [target]);
const events = store.eventsMatchingPredicate(predicate);

const result = [];
for (let i = 0; i < events.count; i++) {
  const e = events.objectAtIndex(i);
  result.push({
    title: e.title.js,
    start: e.startDate.js,
    id: e.eventIdentifier.js
  });
}
console.log(JSON.stringify(result, null, 2));

EventKit time zone example

ObjC.import('EventKit');
ObjC.import('Foundation');

const store = $.EKEventStore.alloc.init;
let granted = false;
const g = $.dispatch_group_create();
$.dispatch_group_enter(g);
store.requestAccessToEntityTypeCompletion($.EKEntityTypeEvent, (ok, err) => { granted = ok; $.dispatch_group_leave(g); });
$.dispatch_group_wait(g, $.DISPATCH_TIME_FOREVER);
if (!granted) throw new Error("Calendar access denied");

const cals = store.calendarsForEntityType($.EKEntityTypeEvent);
let target = null;
for (let i = 0; i < cals.count; i++) {
  const c = cals.objectAtIndex(i);
  if (c.title.js === "Work") { target = c; break; }
}
if (!target) throw new Error("Calendar 'Work' not found");

// Time zone
const tz = $.NSTimeZone.timeZoneWithName("America/New_York");

const evt = $.EKEvent.eventWithEventStore(store);
evt.title = "TZ Event";
evt.timeZone = tz;

// Build start/end using NSDateComponents (safer for TZ)
const cal = $.NSCalendar.currentCalendar;
const comps = $.NSDateComponents.alloc.init;
comps.year = 2026; comps.month = 1; comps.day = 15; comps.hour = 9; comps.minute = 0;
const start = cal.dateFromComponents(comps);
comps.hour = 10; // end time
const end = cal.dateFromComponents(comps);

evt.startDate = start;
evt.endDate = end;
evt.calendar = target;

const err = $();
const ok = store.saveEventSpanCommitError(evt, $.EKSpanThisEvent, true, err);
if (!ok) console.log("Save failed: " + err.localizedDescription.js);