Google Calendar

gcal_list_events

List events on a calendar. Supports time range filtering, search query, and pagination. Use singleEvents=true to expand recurring events into individual instances.

Remote node2flow/google-calendar

Other tools also called gcal_list_events? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text search query to filter events (searches summary, description, location, attendees)"
    },
    "order_by": {
      "enum": [
        "startTime",
        "updated"
      ],
      "type": "string",
      "description": "Sort order: \"startTime\" (requires singleEvents=true) or \"updated\""
    },
    "time_max": {
      "type": "string",
      "description": "Upper bound (exclusive) for event end time in RFC 3339 format (e.g., \"2026-12-31T23:59:59Z\")"
    },
    "time_min": {
      "type": "string",
      "description": "Lower bound (inclusive) for event start time in RFC 3339 format (e.g., \"2026-01-01T00:00:00Z\")"
    },
    "time_zone": {
      "type": "string",
      "description": "Time zone for the response (e.g., \"America/New_York\", \"Asia/Bangkok\")"
    },
    "page_token": {
      "type": "string",
      "description": "Token for next page of results (from previous response nextPageToken)"
    },
    "calendar_id": {
      "type": "string",
      "description": "Calendar ID (use \"primary\" for the main calendar, or a specific calendar ID from gcal_list_calendars)"
    },
    "max_results": {
      "type": "number",
      "description": "Maximum number of events to return (default: 250, max: 2500)"
    },
    "show_deleted": {
      "type": "boolean",
      "description": "Include deleted events (status=cancelled) in results"
    },
    "single_events": {
      "type": "boolean",
      "description": "Expand recurring events into instances (true) or return master events (false). Required for orderBy=startTime"
    }
  }
}