Skip to content

Calendar Create Event

Create a new event on one of the user's real calendars. Heavy per-change consent — the approval prompt shows the target calendar, title, and start–end in the user's timezone, with a shared-calendar warning when others can see the calendar.

MCP name: create_calendar_event

Category: calendar

:warning: Requires consent

Mutates state (retry policy: manual)

Parameters

Name Type Required Description
all_day bool No If true, an all-day event (start/end are dates)
calendar_id str No Target calendar id; defaults to the primary calendar
description str No Event description
end str Yes End: same format as start
location str No Event location
start str Yes Start: ISO datetime for timed events, or YYYY-MM-DD for all-day
summary str Yes Event title
timezone str No IANA timezone for timed events; defaults to the user's configured timezone

Details

Creates an event on a real calendar through the provider seam. Consent is gated in the capability layer (work_buddy.calendar.capabilities) with consent_weight="high", so the prompt fires individually for every create — it is never carried by a workflow grant. The prompt body is rendered from the actual pending change (calendar name, title, start–end in USER_TZ) and escalates when the target calendar is shared.

Requirements

  • calendar