Can I use Acuity Scheduling as a CLI?

Yes. KosmoKrator exposes a Acuity Scheduling CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Acuity Scheduling through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Acuity Scheduling tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Acuity Scheduling credentials stored?

Acuity Scheduling credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Acuity Scheduling MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

other

Acuity Scheduling CLI for AI Agents

Use the Acuity Scheduling CLI from KosmoKrator to call Acuity Scheduling tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

8 functions 7 read 1 write Manual OAuth token auth

Submit Acuity Scheduling feedback View package source

Acuity Scheduling CLI Setup

Acuity Scheduling can be configured headlessly with `kosmokrator integrations:configure acuity-scheduling`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure acuity-scheduling --set access_token="$ACUITY_SCHEDULING_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor acuity-scheduling --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`ACUITY_SCHEDULING_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`ACUITY_SCHEDULING_URL`	URL `url`	no	API Base URL

Call Acuity Scheduling Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call acuity-scheduling.acuity_list_appointments '{
  "minDate": "example_minDate",
  "maxDate": "example_maxDate",
  "calendarID": 1,
  "appointmentTypeID": 1,
  "max": 1,
  "direction": "example_direction"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:acuity-scheduling acuity_list_appointments '{
  "minDate": "example_minDate",
  "maxDate": "example_maxDate",
  "calendarID": 1,
  "appointmentTypeID": 1,
  "max": 1,
  "direction": "example_direction"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs acuity-scheduling --json
kosmo integrations:docs acuity-scheduling.acuity_list_appointments --json
kosmo integrations:schema acuity-scheduling.acuity_list_appointments --json
kosmo integrations:search "Acuity Scheduling" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Acuity Scheduling.

`acuity-scheduling.acuity_list_appointments`

Read read

List appointments from Acuity Scheduling. Returns upcoming and past appointments with client details, date/time, and status. Use filters to narrow results by date range, calendar, or appointment type.

Parameters: minDate, maxDate, calendarID, appointmentTypeID, max, direction

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_list_appointments '{"minDate":"example_minDate","maxDate":"example_maxDate","calendarID":1,"appointmentTypeID":1,"max":1,"direction":"example_direction"}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_list_appointments '{"minDate":"example_minDate","maxDate":"example_maxDate","calendarID":1,"appointmentTypeID":1,"max":1,"direction":"example_direction"}' --json

`acuity-scheduling.acuity_get_appointment`

Read read

Get full details of a specific appointment in Acuity Scheduling by its ID. Returns client info, date/time, location, forms, and status.

Parameters: id

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_get_appointment '{"id":1}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_get_appointment '{"id":1}' --json

`acuity-scheduling.acuity_list_clients`

Read read

List clients from Acuity Scheduling. Search by name, email, or phone. Returns client contact information and history.

Parameters: search, email, max

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_list_clients '{"search":"example_search","email":"example_email","max":1}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_list_clients '{"search":"example_search","email":"example_email","max":1}' --json

`acuity-scheduling.acuity_list_calendars`

Read read

List all calendars in Acuity Scheduling. Returns calendar IDs, names, and timezone info. Use calendar IDs to filter appointments.

Parameters: none

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_list_calendars '{}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_list_calendars '{}' --json

`acuity-scheduling.acuity_list_appointment_types`

Read read

List all appointment types (services) in Acuity Scheduling. Returns type IDs, names, duration, price, and category. Use type IDs to filter appointments or check availability.

Parameters: none

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_list_appointment_types '{}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_list_appointment_types '{}' --json

`acuity-scheduling.acuity_cancel_appointment`

Write write

Cancel an existing appointment in Acuity Scheduling. Requires the appointment ID. The appointment will be marked as cancelled and the client will be notified according to notification settings.

Parameters: id

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_cancel_appointment '{"id":1}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_cancel_appointment '{"id":1}' --json

`acuity-scheduling.acuity_get_availability`

Read read

Get available time slots for booking in Acuity Scheduling. Returns open times for a given appointment type, date, and optional calendar.

Parameters: appointmentTypeID, date, calendarID, timezone

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_get_availability '{"appointmentTypeID":1,"date":"example_date","calendarID":1,"timezone":"example_timezone"}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_get_availability '{"appointmentTypeID":1,"date":"example_date","calendarID":1,"timezone":"example_timezone"}' --json

`acuity-scheduling.acuity_get_current_user`

Read read

Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.

Parameters: none

Generic CLI call

kosmo integrations:call acuity-scheduling.acuity_get_current_user '{}' --json

Provider shortcut

kosmo integrations:acuity-scheduling acuity_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`acuity-scheduling.acuity_list_appointments`

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_list_appointments --json

Parameter	Type	Required	Description
`minDate`	string	no	Earliest appointment date to return (ISO 8601, e.g., "2026-01-01").
`maxDate`	string	no	Latest appointment date to return (ISO 8601, e.g., "2026-12-31").
`calendarID`	integer	no	Filter by calendar ID.
`appointmentTypeID`	integer	no	Filter by appointment type ID.
`max`	integer	no	Maximum number of appointments to return (default: 100).
`direction`	string	no	Sort direction: "asc" (oldest first) or "desc" (newest first). Default: "desc".

`acuity-scheduling.acuity_get_appointment`

Get full details of a specific appointment in Acuity Scheduling by its ID. Returns client info, date/time, location, forms, and status.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_get_appointment --json

Parameter	Type	Required	Description
`id`	integer	yes	The appointment ID.

`acuity-scheduling.acuity_list_clients`

List clients from Acuity Scheduling. Search by name, email, or phone. Returns client contact information and history.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_list_clients --json

Parameter	Type	Required	Description
`search`	string	no	Search query to filter clients by name, email, or phone.
`email`	string	no	Filter clients by exact email address.
`max`	integer	no	Maximum number of clients to return.

`acuity-scheduling.acuity_list_calendars`

List all calendars in Acuity Scheduling. Returns calendar IDs, names, and timezone info. Use calendar IDs to filter appointments.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_list_calendars --json

Parameter	Type	Required	Description
No parameters.

`acuity-scheduling.acuity_list_appointment_types`

List all appointment types (services) in Acuity Scheduling. Returns type IDs, names, duration, price, and category. Use type IDs to filter appointments or check availability.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_list_appointment_types --json

Parameter	Type	Required	Description
No parameters.

`acuity-scheduling.acuity_cancel_appointment`

Cancel an existing appointment in Acuity Scheduling. Requires the appointment ID. The appointment will be marked as cancelled and the client will be notified according to notification settings.

Operation: Write write
Schema command: kosmo integrations:schema acuity-scheduling.acuity_cancel_appointment --json

Parameter	Type	Required	Description
`id`	integer	yes	The appointment ID to cancel.

`acuity-scheduling.acuity_get_availability`

Get available time slots for booking in Acuity Scheduling. Returns open times for a given appointment type, date, and optional calendar.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_get_availability --json

Parameter	Type	Required	Description
`appointmentTypeID`	integer	yes	The appointment type ID to check availability for.
`date`	string	yes	The date to check availability for (YYYY-MM-DD format, e.g., "2026-04-10").
`calendarID`	integer	no	Filter availability for a specific calendar.
`timezone`	string	no	Timezone for the returned times (e.g., "America/New_York"). Defaults to the account timezone.

`acuity-scheduling.acuity_get_current_user`

Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.

Operation: Read read
Schema command: kosmo integrations:schema acuity-scheduling.acuity_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.