Calendar list events

calendar__list_events

Access

Requires a project integration connection for calendar.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
calendarIdstringYesCalendar ID (use 'primary' for main calendar)
timeMinstringNoExact instant lower bound (RFC3339). For a local calendar day use dateFrom, dateTo and timeZone instead.
timeMaxstringNoExact instant upper bound (RFC3339). Local date ranges use dateTo as the exclusive end date.
maxResultsnumberNoMaximum events per page
orderBystringNoOrder by: startTime or updated
singleEventsbooleanNoExpand recurring events
pageTokenstringNoContinuation token from nextPageToken. Keep the other query parameters unchanged.
dateFromstringNoLocal start date, inclusive (YYYY-MM-DD). Use with dateTo and timeZone for date-based searches.
dateTostringNoLocal end date, exclusive (YYYY-MM-DD). For one day, use the following date.
timeZonestringNoIANA timezone for the local date range, e.g. Europe/Berlin.

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.

json
{
  "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

json
{
  "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."
}