calendar_events_list
Retrieve and filter calendar events by calendar ID, time range, search query, and sort order to view schedules or expand recurring events.
Instructions
List events from a calendar.
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": {
"calendarId": "<calendarId>"
},
"name": "calendar_events_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search | |
| orderBy | No | Sort order: startTime or updated | |
| timeMax | No | Upper bound (RFC3339) | |
| timeMin | No | Lower bound (RFC3339, e.g. "2026-03-07T00:00:00Z") | |
| calendarId | Yes | Calendar ID (use 'primary' for main calendar) | |
| maxResults | No | Max events to return | |
| singleEvents | No | Expand recurring events (usually true) |