calendar__list_events
Access
Requires a project integration connection for calendar.
Call type: Can read or manage credentials.
Arguments
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar__list_events",
"arguments": {
"calendarId": "example"
}
}
}Result
No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the calendar integration reference for provider setup and tool context.
Full schemas
{
"type": "object",
"properties": {
"calendarId": {
"type": "string",
"description": "Calendar ID (use 'primary' for main calendar)"
},
"timeMin": {
"type": "string",
"description": "Exact instant lower bound (RFC3339). For a local calendar day use dateFrom, dateTo and timeZone instead."
},
"timeMax": {
"type": "string",
"description": "Exact instant upper bound (RFC3339). Local date ranges use dateTo as the exclusive end date."
},
"maxResults": {
"type": "number",
"description": "Maximum events per page"
},
"orderBy": {
"type": "string",
"description": "Order by: startTime or updated"
},
"singleEvents": {
"type": "boolean",
"description": "Expand recurring events"
},
"pageToken": {
"type": "string",
"description": "Continuation token from nextPageToken. Keep the other query parameters unchanged."
},
"dateFrom": {
"type": "string",
"description": "Local start date, inclusive (YYYY-MM-DD). Use with dateTo and timeZone for date-based searches."
},
"dateTo": {
"type": "string",
"description": "Local end date, exclusive (YYYY-MM-DD). For one day, use the following date."
},
"timeZone": {
"type": "string",
"description": "IANA timezone for the local date range, e.g. Europe/Berlin."
}
},
"required": [
"calendarId"
],
"description": "Arguments for the calendar__list_events tool."
}