Read calendar events
events_listLists flat calendar events, optionally within a time window, ordered by start, so you can see what is planned or find an event ID.
Instructions
List the flat calendar events, optionally inside a time window, ordered by start. Use it to see what is planned or to find an event id; use event_get when you already have the id, and calendar_subscription_get for the feed URL that adds the calendar to a calendar app. A recurring event comes back once with its recurrence rule, not expanded into single dates. Send from and to together to limit the window; without them all events are returned. More than 1000 matches fail with 503 events_window_too_large, so narrow the window. Each event has id, title, description, startsAt, endsAt, allDay, location, recurrence, createdByMemberId and updatedAt.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "events_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Window end: a date or an ISO 8601 datetime with offset. A bare date covers that whole day (sent as 23:59:59.999 UTC). | |
| from | No | Window start: a date (2026-12-01) or an ISO 8601 datetime with offset. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. |