Acuity Scheduling MCP server

Connect Acuity Scheduling to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Acuity Scheduling MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create time block tool in Acuity Scheduling
  • Use the list time blocks tool in Acuity Scheduling
  • Use the list clients tool in Acuity Scheduling
  • Use the check availability tool in Acuity Scheduling
  • Use the create appointment tool in Acuity Scheduling
  • Use the create client tool in Acuity Scheduling

Supported Tools

create_block

Create Time Block

Block off a time range on a specific calendar to prevent appointment scheduling during that period.

list_blocks

List Time Blocks

Retrieve a list of time blocks. Optionally filter by date range or calendar.

list_clients

List Clients

Search and retrieve client records. Filter by name, email, or phone number, or use a general search query.

check_availability

Check Availability

Check available dates for a given month or available time slots for a specific date. Provide a **month** to get available dates, or a **date** to get specific time slots. Both require an appointment type ID.

create_appointment

Create Appointment

Book a new appointment. Requires the appointment datetime, appointment type, and client details. Optionally provide a calendar, custom intake form field values, add-ons, and coupon/certificate codes.

create_client

Create Client

Create a new client record with contact information.

delete_client

Delete Client

Permanently delete a client record.

update_appointment

Update Appointment

Update an existing appointment's client details, notes, or intake form field values. To change the appointment time, use the Reschedule Appointment tool instead.

get_appointment

Get Appointment

Retrieve full details of a specific appointment by ID, including client info, intake form responses, and payment status.

check_certificate

Check Certificate

Validate a certificate or coupon code. Optionally check against a specific appointment type to verify eligibility.

list_appointment_types

List Appointment Types

Retrieve all configured appointment types (service offerings) including their duration, pricing, and associated calendars. Also returns available add-ons.

list_orders

List Orders

Retrieve all orders for packages, gift certificates, and subscriptions.

list_forms

List Intake Forms

Retrieve all intake form definitions configured for the account. Forms are associated with appointment types and collect custom information from clients during booking. Use field IDs when creating or updating appointments with custom field values.

get_account

Get Account Info

Retrieve information about the authenticated Acuity Scheduling account, including the account owner name, email, and timezone.

reschedule_appointment

Reschedule Appointment

Reschedule an existing appointment to a new date and time. Optionally change the calendar. The new datetime must be an available slot.

cancel_appointment

Cancel Appointment

Cancel a scheduled appointment. Optionally include a cancellation note and suppress the cancellation email notification.

update_client

Update Client

Update an existing client's contact information or notes.

delete_certificate

Delete Certificate

Delete a certificate by ID.

list_labels

List Labels

Retrieve all labels used for categorizing and organizing appointments.

delete_block

Delete Time Block

Remove a time block to re-open that time slot for scheduling.

create_certificate

Create Certificate

Create a certificate code for a package or coupon. Provide either a product ID (for packages) or a coupon ID (for coupons). Optionally specify a custom certificate code and assign it to an email.

list_products

List Products

Retrieve all products and packages available in the online store.

get_appointment_payments

Get Appointment Payments

Retrieve payment information for a specific appointment.

list_appointments

List Appointments

Retrieve a list of scheduled appointments. Filter by date range, calendar, appointment type, client name, email, or phone. Defaults to 100 appointments per request; set max to change the result limit.

list_calendars

List Calendars

Retrieve all calendars (staff members or locations) configured in the account. Use calendar IDs when creating appointments or checking availability.

list_certificates

List Certificates

Find package certificate codes by client email, product, order, or appointment type. Combine email and appointment type to discover valid codes for a client before booking.

list_class_availability

List Class Availability

List group class sessions and remaining seats. Filter by month or date range, appointment type, and calendar. Use the returned time, appointment type ID, and calendar ID to book a class.

Connect Acuity Scheduling to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Acuity Scheduling in Metorial. In your Metorial portal, enable the Acuity Scheduling MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Acuity Scheduling tools.

Run Acuity Scheduling through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Acuity Scheduling and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Acuity Scheduling tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Acuity Scheduling

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Google Calendar

Create, read, update, and delete calendar events and calendars. Manage attendees, recurring events, and reminders. Check free/busy availability for scheduling. Share calendars and control access permissions. Create events from natural language text with quick add. Manage special event types like focus time, out of office, and working location. Subscribe to or remove calendars from a user's calendar list. Sync calendar changes incrementally.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Technical notes for Acuity Scheduling

Create, retrieve, update, cancel, and reschedule appointments. Manage availability by querying open dates and time slots for appointment types and calendars. Block time slots to prevent bookings. Manage client records including creation, retrieval, updates, and deletion. List appointment types, add-ons, calendars, and intake forms. Create and validate gift certificates, packages, and coupons. Retrieve orders and product listings.

Frequently asked questions

Common questions about connecting Acuity Scheduling to AI agents with Metorial.

  1. How many tools does the Acuity Scheduling MCP server have?
    The Acuity Scheduling MCP server exposes 27 tools, including Create Time Block, List Time Blocks, List Clients. Each one is governed and traced through Metorial.
  2. Acuity Scheduling exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Acuity Scheduling MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Acuity Scheduling and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Acuity Scheduling MCP server yourself or use the hosted gateway.

Connect Acuity Scheduling to production AI agents

See how Metorial gives your team governed access to Acuity Scheduling, with tracing and security controls built in.