List events
list_eventsRetrieve calendar events across all connected Google accounts within a specified time range, labeled by source account, to answer schedule queries.
Instructions
List events in a time range. With no accounts argument this queries every account you may read and every visible calendar on them, which is what you want for questions like "what do I have tomorrow?". Each event is labelled with the account it came from.
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": {
"time_min": "<time_min>",
"time_max": "<time_max>"
},
"name": "list_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| accounts | No | Account ids to include. If omitted, every account you are permitted to read is included. | |
| calendar | No | Calendar id. Defaults to the account's configured default calendar ("primary" unless changed). | |
| time_max | Yes | End of the range. A bare date means the end of that day. | |
| time_min | Yes | Start of the range. ISO 8601, e.g. "2026-09-20" or "2026-09-20T09:00:00". | |
| timezone | No | IANA timezone for interpreting and displaying times, e.g. "Asia/Jakarta". Defaults to the server timezone. | |
| max_results | No | Maximum events per calendar. Default 250. |