calendar_create_event
Create a new calendar event with start and end dates, summary, location, and recurrence options. The tool verifies the event exists after creation to confirm success.
Instructions
Create a new event. Verifies the event actually exists (by uid) after creation before reporting success — Calendar's scripting dictionary has known flaky spots for event creation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | Yes | ISO 8601 date/time. | |
| summary | No | ||
| location | No | ||
| startDate | Yes | ISO 8601 date/time. | |
| recurrence | No | Raw iCalendar RRULE-style text, e.g. 'FREQ=WEEKLY;INTERVAL=1;COUNT=5'. Editing recurrence on an already-recurring event is a known-flaky area — the tool verifies the change took effect and reports PLATFORM_LIMITATION if not. | |
| alldayEvent | No | ||
| description | No | ||
| calendarName | No | Calendar name. Ambiguous if duplicated (common on multi-account setups) — use calendarIndex instead in that case. | |
| calendarIndex | No | Position from calendar_list_calendars, for disambiguating duplicate calendar names. Stable only for the current Calendar.app process. |