create_calendar_event
Creates a single, one-off calendar event on the household calendar. Timed events need startDateTime; all-day events need startDate (plus endDate for several days). Set reminders with reminderOffsetMinutes. For a repeating schedule use create_recurring_calendar_event instead.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"notes": "Bring insurance card",
"title": "Dentist appointment",
"isAllDay": false,
"location": {
"$type": "Address",
"line1": "221B Baker Street",
"postalCode": "NW1 6XE",
"countryCode": "GB"
},
"timezone": "Europe/London",
"description": "Annual checkup with Dr. Smith",
"endDateTime": "2026-08-03T15:30:00Z",
"startDateTime": "2026-08-03T14:30:00Z",
"reminderOffsetMinutes": [
60,
1440
]
},
"name": "create_calendar_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Freeform notes. | |
| title | Yes | Title shown in calendar views. | |
| endDate | No | All-day only: LAST day, inclusive, YYYY-MM-DD. Omit for a single day. The event may cover at most 366 days, between 1900 and 2200. | |
| isAllDay | Yes | True for all-day, false for timed. | |
| location | No | Where it happens. $type 'Address' takes line1-3/postalCode/countryCode; 'OnlineLocation' takes url/notes. | |
| timezone | No | IANA zone for the wall-clock times, e.g. 'Europe/London'. Null means UTC. Not stored when an all-day event is sent with startDate. | |
| startDate | No | All-day only (preferred for all-day): first day, YYYY-MM-DD. Takes precedence over startDateTime. Stored as startDateTime 00:00Z on this day, with endDateTime 00:00Z on the last day (null for a single day). | |
| description | No | Longer description. | |
| endDateTime | No | End of a timed event, ISO 8601 UTC. Must not precede startDateTime. For all-day events send endDate instead. An all-day event sent with endDateTime and no startDate stores it as given, and a midnight endDateTime then names the LAST day (inclusive). | |
| startDateTime | No | Start of a timed event, ISO 8601 UTC with a Z suffix. For an all-day event send startDate instead; when startDate is present this is ignored. | |
| reminderOffsetMinutes | No | Reminder lead times, in minutes before the event starts. Each value is whole hours, 60-1380 (1-23 hours), or whole days, a multiple of 1440 up to 525600 (365 days); a week is 10080. Up to 5 values. An all-day event counts from 00:00 on its first day, so 300 (5 hours) is 19:00 the evening before. Day and week reminders arrive at 19:00 on the earlier day; hour reminders arrive that many hours before the start, or up to 15 minutes earlier. Every household member is reminded. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| title | No | ||
| message | No | ||
| variant | No |