How to Use the Acuity Scheduling MCP in VS Code Copilot

Q: Can VS Code Copilot read our Acuity Scheduling availability?

Yes. The agent uses the checkavailabilitydates tool to scan specific months. It reads the open slots and helps you write logic that handles fully booked days.

Share Acuity Scheduling MCP Server access across your engineering team in VS Code Copilot to pull live booking data directly into your shared codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Acuity Scheduling MCP to VS Code Copilot

Create your Vinkius account to connect Acuity Scheduling to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Acuity Scheduling with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Access Appointment Types and Products

The `list_appointment_types` tool retrieves all active bookable services offered in your account. Copilot reads the duration, price, and category for each service. Your team builds pricing pages using the actual data returned by the API. Querying `list_products` pulls your available gift certificates and physical items. A developer asks the agent to generate a checkout flow. The AI populates the cart logic with real product IDs from your scheduling system.

Query the Acuity Scheduling MCP Server for Classes

Calling `list_classes` fetches your scheduled group sessions along with their capacity limits. Your agent checks the enrolled counts before writing validation logic for your registration forms. It knows exactly how the payload structures class limits. Identifying who teaches those classes requires `list_calendars`. This tool grabs the provider and instructor profiles attached to your account. Copilot references these profiles to build accurate staff directories in your frontend code.

Retrieve Account and Booking Details

Running `get_account` pulls the core business profile and settings from the connected account. You command the editor to configure environment variables. The AI extracts the correct timezone and business name directly from the source. Pulling specific session data relies on `get_appointment` to fetch the full record via its unique ID. Your team tests webhook handlers by having the agent pull a real booking payload. Nobody wastes time writing JSON fixtures by hand.

Setup guide

Set up Acuity Scheduling MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Acuity Scheduling MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Acuity Scheduling tools listed. Try asking: "List my recent Acuity Scheduling transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "acuity-scheduling-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Acuity Scheduling. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Acuity Scheduling now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Acuity Scheduling MCP in VS Code Copilot

Create a .vscode/mcp.json file in your repository root. Add the server configuration and commit it to version control. Every developer on your team gets instant access to the booking data when they pull the branch.

Yes. The agent uses the check_availability_dates tool to scan specific months. It reads the open slots and helps you write logic that handles fully booked days.

The tools retrieve durations, prices, categories, and date ranges. Your agent formats this raw API output into usable code snippets for your frontend components.

No. You configure the connection once in your workspace settings. Copilot automatically registers the tools for anyone working in that shared project.

Vinkius isolates your connection within a stateless V8 sandbox. Your instructor names, class enrollments, and business profile settings stream directly to your editor. We destroy the environment the moment the sync completes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript