List Calendar Events
list_eventsLists calendar event resources and recurring series masters, excluding individual occurrences; expand recurrences with a calendar view query for date-range agendas.
Instructions
List calendar event resources (/me/events). Returns series masters for recurring meetings, NOT individual occurrences. For 'what's on my calendar between X and Y' use list_calendar_view instead — it expands recurrences into instances.
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": "list_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Number of events to return (default: 25) | |
| filter | No | OData filter expression | |
| 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. | |
| fetch_all_pages | No | Fetch all pages of results (max 50 pages) |