google-calendar_list_events
Retrieve events from a Google Calendar with filters for time ranges, search terms, event ordering, and pagination. Supports recurring event expansion and deleted event inclusion.
Instructions
Returns events on the specified 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": "google-calendar_list_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text search terms to find events | |
| orderBy | No | Order by the start time or last modification time (startTime, updated) | |
| timeMax | No | Upper bound for event's start time (RFC3339 timestamp) | |
| timeMin | No | Lower bound for event's end time (RFC3339 timestamp) | |
| timeZone | No | Time zone used in the response | |
| pageToken | No | Token specifying which result page to return | |
| calendarId | Yes | Calendar identifier. Use 'primary' for the primary calendar | |
| maxResults | No | Maximum number of events returned (default 250, max 2500) | |
| showDeleted | No | Whether to include deleted events | |
| singleEvents | No | Whether to expand recurring events into instances |