# Acuity Scheduling tools in Cogny Cogny's Acuity Scheduling integration exposes 21 tools (19 read, 1 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (19): only reads data. - **Write** (1): creates or changes something. - **Destructive** (1): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Notes Acuity Scheduling connects with two values from Acuity → Integrations → API (View credentials): the numeric User ID and the API Key. Acuity API keys have no scopes: the key can read every appointment, client, form answer and store order in the account, so treat it like the account password. Regenerating the key in Acuity disconnects Cogny until you paste the new one. `get_bookings_summary` counts appointments by their appointment date over a range of up to 92 days: booked (scheduled, not canceled), canceled, and no-shows (canceled appointments an admin marked as a no-show), with cancellation and no-show rates over all three. `booked_value` sums the listed price of scheduled appointments and `amount_paid` what clients have paid on them, in the account's currency. It also lists the coupon and package codes used most. Acuity has no paging on its lists: `max` caps the number of results (default 100, up to 1,000 here). When a list reaches `max`, narrow the date range. The summary reads in 7-day windows and says when a window hit Acuity's cap. Acuity allows 10 API requests per second and 20 concurrent connections. Writes stay ask-first until you allow them in Settings. A code created with `create_certificate` works on your live scheduler at once; `delete_certificate` can't be undone, and a client holding a deleted package code loses what was left on it. ## Known gaps - Appointments can't be booked, canceled or rescheduled, and appointment notes, labels and intake answers can't be edited. - Coupons themselves can't be created or edited, and no tool lists coupons: `create_certificate` issues a code for a coupon you already made in Acuity, using the coupon's id. - Appointment types, prices, availability and blocked-off time can't be changed. - Summary counts are by appointment date; there is no "booked on" breakdown, booking source or UTM data, and no new-versus-returning client split. - Clients can't be created, edited or deleted, and the client list has no date filter. - Booking webhooks aren't used: Cogny reads the API when asked. ## All tools | Tool | Kind | What it does | |---|---|---| | `get_account_info` | Read | Show the connected Acuity Scheduling account: business name, plan, currency, timezone and scheduling page. | | `list_appointments` | Read | List appointments booked in Acuity, filtered by date range, appointment type, calendar, status or client. | | `get_appointment` | Read | Get one Acuity appointment with its client, price, payment status, labels and intake form answers. | | `get_appointment_payments` | Read | List the payment transactions recorded for one Acuity appointment. | | `get_bookings_summary` | Read | Summarise Acuity bookings for a date range: booked, canceled and no-show counts, booked value and amount paid, per day, appointment type and calendar. | | `list_appointment_types` | Read | List the services and classes clients can book in Acuity, with price, duration, category, visibility and calendars. | | `list_appointment_addons` | Read | List the add-ons clients can pick when booking in Acuity, with their price and extra time. | | `list_calendars` | Read | List the Acuity calendars (staff members, rooms or locations) this account can see. | | `list_labels` | Read | List the labels the business uses to mark Acuity appointments (e.g. | | `list_forms` | Read | List Acuity intake forms with their fields and the appointment types they are attached to. | | `get_available_dates` | Read | List the dates in a month that still have open slots for one Acuity appointment type, as clients see them. | | `get_available_times` | Read | List the open time slots on one date for an Acuity appointment type, as clients see them. | | `list_class_availability` | Read | List scheduled Acuity class sessions in a month with their size and remaining open slots. | | `list_clients` | Read | List Acuity clients, optionally searched by first name, last name or phone number. | | `list_products` | Read | List the products, packages and gift certificates sold in the Acuity online store, with price and visibility. | | `list_orders` | Read | List online store orders in Acuity, newest first, with total, status (paid, unpaid, delivered) and buyer. | | `get_order` | Read | Get one Acuity store order with its items, total, status and buyer. | | `list_certificates` | Read | List package, gift and coupon certificate codes in Acuity, with what they cover and what is left on them. | | `check_certificate` | Read | Check whether a coupon or package code is valid for an Acuity appointment type, optionally for one client email. | | `create_certificate` | Write | Create a coupon or package code in Acuity that clients can redeem when booking; only after the user confirms. | | `delete_certificate` | Destructive | Delete a coupon or package code in Acuity so it can no longer be redeemed; only after the user confirms. | Exact input schemas come from `tools/list` once Acuity Scheduling is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt