List events
list_eventsList calendar events that overlap a time range, including recurring occurrences, sorted by start time; defaults to the next seven days.
Instructions
List calendar events (recurring events are expanded into occurrences) that overlap a time range, sorted by start. Defaults to the next 7 days from today (UTC). Returned times are UTC.
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 |
|---|---|---|---|
| end | No | Range end (default: start + 7 days) | |
| limit | No | Maximum events (default 100) | |
| start | No | Range start (ISO 8601; without an offset it is UTC unless timeZone is given) | |
| calendar | No | Calendar (default: the main calendar). Accepts a well-known name (inbox, drafts, sentitems/sent, deleteditems/trash, junkemail/junk, archive, outbox), a display name or path such as "Inbox/Projects", or a folder ID from list_folders | |
| timeZone | No | IANA time zone for start/end without an offset, e.g. "Europe/London" |