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 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.

8 functions 7 read 1 write Manual OAuth token auth

Submit Acuity Scheduling feedback View package source

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.

Machine-Readable Metadata

integration_slug: acuity-scheduling
route_slug: acuity-scheduling
package: acuity-scheduling
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Acuity Scheduling CLIHeadless setup and direct function calls. Acuity Scheduling MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Acuity Scheduling MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Acuity Scheduling.

Acuity Scheduling CLI Matrix

Use these pages for direct Acuity Scheduling CLI workflows in scripts, CI, cron, and agent wrappers.

CI Acuity Scheduling CLI for CI. Cron Jobs Acuity Scheduling CLI for cron jobs. Shell Scripts Acuity Scheduling CLI for shell scripts. Headless Automation Acuity Scheduling CLI for headless automation. Coding Agents Acuity Scheduling CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`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_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_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_current_user`	Read `read`	0	Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.