Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Acuity Scheduling

Scalekit connector
Open markdown

The Acuity Scheduling connector lets your AI agent act in each user's Acuity Scheduling account. Each user connects their own Acuity Scheduling API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.

Tools
30
What they doRead · write · destructive
21 · 6 · 321 read6 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Acuity Scheduling connection

    In AgentKit > Connections, create an Acuity Scheduling connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • acuityscheduling_appointment_addons_listList the add-ons configured in the Acuity account.Read-only

    List Appointment Add-ons

    List the add-ons configured in the Acuity account. Returns each add-on's id, name, duration, price and private flag. Use this to get addon_ids for availability checks and bookings.

    Inputs

    This tool takes no inputs.

  • acuityscheduling_appointment_getGet one Acuity appointment by its numeric ID.Read-only

    Get Appointment

    Get one Acuity appointment by its numeric ID. Returns the appointment's client details, datetime, endTime, type, calendar, price, payment status, certificate, intake forms, notes and labels. Use this when you already have the appointment ID. Use List Appointments to search by date or client.

    Inputs

    appointment_idintegerrequired
    Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
    past_form_answersboolean
    Set true to include the client's previous answers to this appointment's intake forms. Example: true.
  • acuityscheduling_appointment_payments_listList the payment transactions recorded for one Acuity appointment.Read-only

    List Appointment Payments

    List the payment transactions recorded for one Acuity appointment. Returns each transaction's ID, processor, amount and creation time. Use this to check how an appointment was paid. Use Get Appointment for the paid and amountPaid summary.

    Inputs

    appointment_idintegerrequired
    Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
  • acuityscheduling_appointment_types_listList the appointment types offered in the Acuity account.Read-only

    List Appointment Types

    List the appointment types offered in the Acuity account. Returns each type's id, name, duration, price, category, description, calendarIDs, form IDs and whether it is a class. Use this to get the appointment_type_id the availability and booking tools need.

    Inputs

    include_deletedboolean
    Set true to include deleted appointment types. Example: true.
  • acuityscheduling_appointments_listList scheduled appointments in the Acuity account, filtered by date range, calendar, appointment type or client details.Read-only

    List Appointments

    List scheduled appointments in the Acuity account, filtered by date range, calendar, appointment type or client details. Returns appointment objects with id, client name, email and phone, datetime, endTime, type, calendar, price, paid status, forms and labels. Use this to find appointments. Use Get Appointment for one appointment by ID. Set canceled to list canceled appointments instead.

    Inputs

    appointment_type_idinteger
    Only return appointments of this appointment type. Get IDs from List Appointment Types. Example: 1.
    calendar_idinteger
    Only return appointments on this calendar. Get IDs from List Calendars. Example: 2.
    canceledboolean
    Set true to return canceled appointments instead of scheduled ones. Acuity defaults to false. Example: true.
    directionstring
    Sort order by appointment date: ASC or DESC. Acuity defaults to DESC. Example: ASC.one of ASCDESC
    emailstring
    Client e-mail address to filter by. Example: bob.mctest@example.com.
    exclude_formsboolean
    Set true to leave intake form answers out of the response, which makes it faster. Example: true.
    first_namestring
    Client first name to filter by. Example: Bob.
    last_namestring
    Client last name to filter by. Example: McTest.
    maxinteger
    Maximum number of results to return. Acuity defaults to 100. Example: 50.
    max_datestring
    Only return appointments on or before this date (YYYY-MM-DD). Example: 2026-01-31.
    min_datestring
    Only return appointments on or after this date (YYYY-MM-DD). Example: 2026-01-01.
    phonestring
    Client phone number to filter by, with the country code. Example: +15551234567.
  • acuityscheduling_availability_classes_listList scheduled class sessions with open spots in Acuity, for a month or date range.Read-only

    Get Available Classes

    List scheduled class sessions with open spots in Acuity, for a month or date range. Returns each class session's id, appointmentTypeID, calendarID, name, time, duration, slots and slotsAvailable. Use this for class (group) appointment types. Use Get Available Times for one-on-one types.

    Inputs

    appointment_type_idinteger
    Only return classes of this appointment type. By default all class types are checked. Example: 5.
    calendar_idinteger
    Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
    include_privateboolean
    Set true to also list classes marked private. Example: true.
    include_unavailableboolean
    Set true to also list classes that are full or no longer bookable. Example: true.
    max_datestring
    Only return classes on or before this date (YYYY-MM-DD). Example: 2026-01-31.
    min_datestring
    Only return classes on or after this date (YYYY-MM-DD). Example: 2026-01-01.
    monthstring
    Month to check, as YYYY-MM. Overrides min_date and max_date. Example: 2026-02.
    timezonestring
    IANA time zone used to convert the returned times. Example: America/New_York.
  • acuityscheduling_availability_dates_listList the dates in a month that have open slots for an Acuity appointment type.Read-only

    Get Available Dates

    List the dates in a month that have open slots for an Acuity appointment type. Returns a list of objects with a date (YYYY-MM-DD). Use this first to find bookable days, then Get Available Times for the slots on a day.

    Inputs

    appointment_type_idintegerrequired
    Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
    monthstringrequired
    Month to check, as YYYY-MM. Example: 2026-02.
    addon_idsarray
    Add-on IDs to include when calculating availability. The add-ons must belong to the appointment type. Get IDs from List Appointment Add-ons. Example: [3, 4].
    calendar_idinteger
    Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
    timezonestring
    IANA time zone used to convert the returned times. Example: America/New_York.
  • acuityscheduling_availability_time_checkCheck whether one date and time is open for an Acuity appointment type before booking it.Read-only

    Check Available Time

    Check whether one date and time is open for an Acuity appointment type before booking it. Returns the checked datetime, appointmentTypeID and calendarID with valid set to true when the slot is open; Acuity returns an error when it is not. Use this right before Create Appointment to confirm a slot. It books nothing.

    Inputs

    appointment_type_idintegerrequired
    Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
    datetimestringrequired
    Date and time to check, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-03T14:00:00-0800.
    calendar_idinteger
    Calendar to check. If omitted, any available calendar counts. Example: 2.