update_calendar_event
Updates fields on an existing single calendar event; only the fields supplied are changed, all others keep their current value. Imported (subscription-sourced) events cannot be edited.
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": {
"id": "0198f3a1b2c34d5e6f7089ab1c2d3e4f",
"notes": "Moved to Thursday",
"endDateTime": "2026-08-04T15:30:00Z",
"startDateTime": "2026-08-04T14:30:00Z"
},
"name": "update_calendar_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Event id from create_calendar_event or list_calendar_events. | |
| notes | No | New notes. | |
| title | No | New event title. | |
| endDate | No | All-day only: new LAST day, inclusive, YYYY-MM-DD. Alone it keeps the current first day. Dates are stored in the event's own end rule (see list_calendar_events). | |
| isAllDay | No | True for all-day, false for timed. | |
| location | No | Replaces the location outright. $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. | |
| startDate | No | All-day only (preferred for all-day): new first day, YYYY-MM-DD. Without endDate the event becomes a single day. | |
| description | No | New description. | |
| endDateTime | No | New end of a timed event, ISO 8601 UTC. Must not precede startDateTime. For all-day events send endDate instead. An all-day endDateTime is stored as given and keeps the event's own end rule (see list_calendar_events): with no source a midnight end names the LAST day, on a device-calendar event the day after it. | |
| startDateTime | No | New start of a timed event, ISO 8601 UTC. For an all-day event send startDate instead. | |
| reminderOffsetMinutes | No | New reminder lead times, in minutes before the event starts. Send the full list: it replaces the current one. [] clears all reminders; omit to keep them. Reminders move with the start. Not allowed on imported events (device calendar or subscription). 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 |