KosmoKrator

productivity

Acuity Scheduling MCP, CLI, and Lua Integration for AI Agents

Acuity Scheduling integration docs for AI agents: MCP gateway setup, Acuity Scheduling CLI commands, Lua API reference, credentials, and function schemas.

Acuity Scheduling for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Machine-Readable Metadata

Function Catalog

FunctionTypeParametersDescription
acuity-scheduling.acuity_list_appointments Read read 6 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.
acuity-scheduling.acuity_get_appointment Read read 1 Get full details of a specific appointment in Acuity Scheduling by its ID. Returns client info, date/time, location, forms, and status.
acuity-scheduling.acuity_create_appointment Write write 1 Create an appointment in Acuity Scheduling.
acuity-scheduling.acuity_update_appointment Write write 2 Update editable Acuity Scheduling appointment details such as client info, notes, fields, labels, or smsOptIn.
acuity-scheduling.acuity_reschedule_appointment Write write 2 Reschedule an appointment to a new datetime, calendar, or both.
acuity-scheduling.acuity_list_appointment_payments Read read 1 Retrieve payment transactions for a specific Acuity Scheduling appointment.
acuity-scheduling.acuity_list_clients Read read 3 List clients from Acuity Scheduling. Search by name, email, or phone. Returns client contact information and history.
acuity-scheduling.acuity_create_client Write write 1 Create a new Acuity Scheduling client record.
acuity-scheduling.acuity_update_client Write write 2 Update an Acuity Scheduling client by lookup parameters and replacement fields.
acuity-scheduling.acuity_list_calendars Read read 0 List all calendars in Acuity Scheduling. Returns calendar IDs, names, and timezone info. Use calendar IDs to filter appointments.
acuity-scheduling.acuity_list_appointment_types Read read 0 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.
acuity-scheduling.acuity_cancel_appointment Write write 1 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.
acuity-scheduling.acuity_get_availability Read read 4 Get available time slots for booking in Acuity Scheduling. Returns open times for a given appointment type, date, and optional calendar.
acuity-scheduling.acuity_get_availability_dates Read read 1 Return dates with availability for a month and appointment type.
acuity-scheduling.acuity_get_availability_classes Read read 1 Return available classes for a month.
acuity-scheduling.acuity_list_forms Read read 0 List intake forms and their fields from Acuity Scheduling.
acuity-scheduling.acuity_list_products Read read 0 List products and packages from Acuity Scheduling.
acuity-scheduling.acuity_list_orders Read read 1 List package, gift certificate, subscription, and product orders from Acuity Scheduling.
acuity-scheduling.acuity_get_order Read read 1 Get details about a single Acuity Scheduling order by ID.
acuity-scheduling.acuity_create_certificate Write write 1 Create a package or coupon certificate code in Acuity Scheduling.
acuity-scheduling.acuity_list_blocks Read read 1 List blocked-off times for the authenticated Acuity Scheduling user.
acuity-scheduling.acuity_create_block Write write 1 Block off time on an Acuity Scheduling calendar.
acuity-scheduling.acuity_delete_block Write write 1 Delete a blocked-off time by ID.
acuity-scheduling.acuity_list_webhooks Read read 0 List dynamic webhook subscriptions in Acuity Scheduling.
acuity-scheduling.acuity_create_webhook Write write 1 Create a dynamic webhook subscription for Acuity Scheduling events.
acuity-scheduling.acuity_delete_webhook Write write 1 Delete a dynamic webhook subscription by ID.
acuity-scheduling.acuity_api_get Read read 2 Call any Acuity Scheduling API v1 GET endpoint.
acuity-scheduling.acuity_api_post Write write 2 Call any Acuity Scheduling API v1 POST endpoint.
acuity-scheduling.acuity_api_put Write write 2 Call any Acuity Scheduling API v1 PUT endpoint.
acuity-scheduling.acuity_api_delete Write write 2 Call any Acuity Scheduling API v1 DELETE endpoint.
acuity-scheduling.acuity_get_current_user Read read 0 Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.