List Calendar Events in a Date Range
list_calendar_viewList calendar event instances between two dates, expanding recurring series into individual occurrences. Use it to answer questions like what's on my calendar this week.
Instructions
List event instances on the calendar between start_date_time and end_date_time. Expands recurring series into individual occurrences (unlike list_events which returns series masters). Use this for 'what's on my calendar this week'.
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": {
"start_date_time": "<start_date_time>",
"end_date_time": "<end_date_time>"
},
"name": "list_calendar_view"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Max events to return (default: 50) | |
| time_zone | No | Show times in this zone: an IANA name (America/New_York) or a Windows one (Eastern Standard Time). Default: UTC. Pass the user's own zone to read times as they would. | |
| calendar_id | No | ID of the calendar to use, from list_calendars. Omit for your default calendar. | |
| end_date_time | Yes | Window end (ISO 8601, e.g. 2026-05-29T00:00:00Z) | |
| start_date_time | Yes | Window start (ISO 8601, e.g. 2026-05-22T00:00:00Z) |