calendar.list
List calendar events with optional date filtering
Scope: calendar:read
List events on the identity's calendar. Supports date range filtering.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results (default: 50, max: 100) |
from | string | No | Filter: events starting from (ISO 8601) |
to | string | No | Filter: events starting before (ISO 8601) |
Example
Agent: "What's on my calendar this week?"
-> calendar.list({
from: "2026-04-06T00:00:00.000Z",
to: "2026-04-12T23:59:59.000Z"
})Returns
{
"events": [
{
"eventId": "evt_abc123",
"title": "Team Sync",
"description": "Weekly standup",
"startAt": "2026-04-07T10:00:00.000Z",
"endAt": "2026-04-07T11:00:00.000Z",
"isAllDay": false,
"location": "Zoom"
}
],
"count": 1
}REST Equivalent
GET /v0/calendar