integrations tools acuity-scheduling
Acuity Scheduling MCP for your AI agent
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.
- 19readonly reads data.
- 1writecreates or changes something.
- 1destructivedeletes, 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. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Acuity Scheduling in Cogny. Every Acuity Scheduling tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
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_certificateissues 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.
what each tool does.
Read 19 · only reads data
get_account_infoReadShow the connected Acuity Scheduling account: business name, plan, currency, timezone and scheduling page.list_appointmentsReadList appointments booked in Acuity, filtered by date range, appointment type, calendar, status or client.get_appointmentReadGet one Acuity appointment with its client, price, payment status, labels and intake form answers.get_appointment_paymentsReadList the payment transactions recorded for one Acuity appointment.get_bookings_summaryReadSummarise 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_typesReadList the services and classes clients can book in Acuity, with price, duration, category, visibility and calendars.list_appointment_addonsReadList the add-ons clients can pick when booking in Acuity, with their price and extra time.list_calendarsReadList the Acuity calendars (staff members, rooms or locations) this account can see.list_labelsReadList the labels the business uses to mark Acuity appointments (e.g.list_formsReadList Acuity intake forms with their fields and the appointment types they are attached to.get_available_datesReadList the dates in a month that still have open slots for one Acuity appointment type, as clients see them.get_available_timesReadList the open time slots on one date for an Acuity appointment type, as clients see them.list_class_availabilityReadList scheduled Acuity class sessions in a month with their size and remaining open slots.list_clientsReadList Acuity clients, optionally searched by first name, last name or phone number.list_productsReadList the products, packages and gift certificates sold in the Acuity online store, with price and visibility.list_ordersReadList online store orders in Acuity, newest first, with total, status (paid, unpaid, delivered) and buyer.get_orderReadGet one Acuity store order with its items, total, status and buyer.list_certificatesReadList package, gift and coupon certificate codes in Acuity, with what they cover and what is left on them.check_certificateReadCheck whether a coupon or package code is valid for an Acuity appointment type, optionally for one client email.
Write 1 · creates or changes something
create_certificateWriteCreate a coupon or package code in Acuity that clients can redeem when booking; only after the user confirms.
Destructive 1 · deletes, removes or replaces something
delete_certificateDestructiveDelete 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.