> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Calendar Events List

> Build a list of the user's calendar events from Google Calendar, Outlook Calendar, or all connected calendars.



## OpenAPI

````yaml /api-reference/v1/v1.1.0_openapi.json post /action/get_calendar_events_list
openapi: 3.0.0
info:
  version: 1.1.0
  title: AI Actions - Get Data
  description: API specifications for 'Get Data' category AI actions.
  license:
    name: MIT
servers:
  - url: https://api-lr.agent.ai/v1
security:
  - bearerAuth: []
paths:
  /action/get_calendar_events_list:
    post:
      tags:
        - Integration Intelligence
      summary: Get Calendar Events List
      description: >-
        Build a list of the user's calendar events from Google Calendar, Outlook
        Calendar, or all connected calendars.
      operationId: getCalendarEventsList
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                calendar_provider:
                  type: string
                  enum:
                    - all
                    - googlecalendar
                    - outlook
                  description: >-
                    Calendar service to use. Select 'All Connected Calendars' to
                    combine events from all providers.
                  default: all
                event_filter:
                  type: string
                  enum:
                    - past
                    - future
                    - both
                  description: Select which events to retrieve based on their timing.
                  default: future
                with_notetaker_transcript_only:
                  type: boolean
                  description: >-
                    When Event Filter is Past, only include events that have a
                    notetaker recording with transcript (for post-meeting
                    follow-up agent). Default: off for backwards compatibility.
                  default: false
                max_events:
                  type: string
                  description: Maximum number of events to retrieve (e.g., 30).
                  default: '30'
                  pattern: ^[0-9]+$
                primary_calendar_only:
                  type: boolean
                  description: Only retrieve events from the user's primary calendar.
                  default: true
                output_format:
                  type: string
                  enum:
                    - json
                    - text
                    - dropdown_option
                  description: Choose how the calendar events should be formatted.
                  default: json
                output_variable_name:
                  type: string
                  description: >-
                    Provide a variable name to store the calendar events list,
                    like 'calendar_events' or 'upcoming_meetings'.
                  pattern: ^[a-zA-Z][a-zA-Z0-9_]*$
              required:
                - calendar_provider
                - event_filter
                - max_events
                - primary_calendar_only
                - output_format
                - output_variable_name
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
        '401':
          description: Unauthorized - invalid or missing bearer token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
components:
  schemas:
    ActionResponse:
      type: object
      properties:
        status:
          type: integer
          format: int32
          description: HTTP status code of the action response
        response:
          type: object
          description: Response data from the action
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token from your account
        ([https://agent.ai/user/integrations#api](https://agent.ai/user/integrations#api))

````