KosmoKrator

other

Acuity Scheduling MCP Integration for OpenAI Agents SDK

Connect Acuity Scheduling to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 7 read 1 write Manual OAuth token auth
Submit Acuity Scheduling feedback View package source

Connect Acuity Scheduling to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Acuity Scheduling MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-acuity-scheduling": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=acuity-scheduling",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=acuity-scheduling --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Acuity Scheduling instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Acuity Scheduling Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Acuity Scheduling integration catalog.

MCP toolSource functionTypeDescription
integration__acuity_scheduling__acuity_list_appointments acuity-scheduling.acuity_list_appointments 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.
integration__acuity_scheduling__acuity_get_appointment acuity-scheduling.acuity_get_appointment Read Get full details of a specific appointment in Acuity Scheduling by its ID. Returns client info, date/time, location, forms, and status.
integration__acuity_scheduling__acuity_list_clients acuity-scheduling.acuity_list_clients Read List clients from Acuity Scheduling. Search by name, email, or phone. Returns client contact information and history.
integration__acuity_scheduling__acuity_list_calendars acuity-scheduling.acuity_list_calendars Read List all calendars in Acuity Scheduling. Returns calendar IDs, names, and timezone info. Use calendar IDs to filter appointments.
integration__acuity_scheduling__acuity_list_appointment_types acuity-scheduling.acuity_list_appointment_types 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.
integration__acuity_scheduling__acuity_cancel_appointment acuity-scheduling.acuity_cancel_appointment 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.
integration__acuity_scheduling__acuity_get_availability acuity-scheduling.acuity_get_availability Read Get available time slots for booking in Acuity Scheduling. Returns open times for a given appointment type, date, and optional calendar.
integration__acuity_scheduling__acuity_get_current_user acuity-scheduling.acuity_get_current_user Read Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.

Related Acuity Scheduling Pages

Acuity Scheduling CLIUse direct JSON commands instead of MCP discovery. Acuity Scheduling MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.