Create a calendar event
event_createCreate one-off or repeating events in a shared flat calendar and notify other flat members. Requires a title and start time; supports all-day events, locations, and recurrence rules.
Instructions
Add a new event, one-off or repeating, to the flat calendar. Use it for something new; use event_update to change an existing event, and absence_create instead when a member is away. Not idempotent: calling it twice creates two events. The other flat members are notified about the new event, not the caller. An endsAt before startsAt fails with ends_before_start. Returns the created event with its id and a warning that is null unless the push delivery could not be confirmed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"startsAt": "<startsAt>"
},
"name": "event_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Short name of the event, shown in the calendar and the notification. | |
| allDay | No | true for an event that lasts the whole day (no clock time), false for one at a specific time. Defaults to false. | |
| endsAt | No | Optional end as ISO 8601 datetime with offset, not before startsAt. Omit or send null for an event without an end time. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| location | No | Optional place, for example "Kitchen" or an address. | |
| startsAt | Yes | Start as ISO 8601 datetime with offset, for example 2026-12-05T19:00:00+01:00; the year must be 1900..2200. For an all-day event only the date counts: send the date at T00:00:00Z. | |
| recurrence | No | Repeat rule, an RFC 5545 subset with parts separated by ";", for example "FREQ=WEEKLY;BYDAY=MO,TH;COUNT=10". FREQ=DAILY|WEEKLY|MONTHLY|YEARLY is required; optional INTERVAL 1..365, BYDAY (MO..SU), COUNT 1..366, UNTIL. Anything else fails with recurrence_invalid. | |
| description | No | Optional longer details for the event. |