Appointo MCP server

Connect Appointo 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 Appointo MCP server

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

  • Use the update appointment configuration tool in Appointo
  • Use the reschedule booking tool in Appointo
  • Use the list subscription contracts tool in Appointo
  • Use the list bookings tool in Appointo
  • Use the create booking tool in Appointo
  • Use the list products tool in Appointo

Supported Tools

update_appointment_config

Update Appointment Configuration

Update an appointment's configuration, including timezone, duration, interval, capacity, buffer times, reminders (email, SMS, WhatsApp), location, cancellation/rescheduling permissions and cutoff durations, weekly availability slots with per-slot surge pricing and capacity overrides, and date-specific overrides.

reschedule_booking

Reschedule Booking

Reschedule an existing booking to a new timeslot. Can reschedule the entire booking or only specific customers within a group booking. Use the override option to forcefully reschedule to a given timeslot.

list_subscription_contracts

List Subscription Contracts

Retrieve recurring booking subscription contracts. Search by product name, variant name, order number, or customer name.

list_bookings

List Bookings

Retrieve bookings from Appointo. Filter by status (past or upcoming), search by product name, customer name, email, phone, or order name. Retrieve a specific booking by ID. Supports pagination.

create_booking

Create Booking

Create a new booking in Appointo. Requires an appointment ID, timeslot, and customer details (name and email). Optionally specify quantity for group bookings.

list_products

List Products

Retrieve bookable products (services) configured in Appointo. Products represent the bookable services or items offered by the business. Use search to filter products by name. Supports pagination.

update_booking

Update Booking Buffers

Update buffer times on an existing booking. Buffer times add padding before and/or after the booking timeslot.

cancel_booking

Cancel Booking

Cancel an existing booking. Can cancel the entire booking or only specific customers within a group booking by providing customer IDs.

list_appointments

List Appointments

Retrieve appointment types configured in Appointo. Optionally filter by a specific appointment ID or product ID. Supports pagination.

get_availability

Get Calendar Availability

Check calendar availability for a specific appointment within a date range. Returns available time slots. Optionally filter by specific team members.

list_cancelled_bookings

List Cancelled Bookings

Retrieve cancelled bookings for cancellation follow-up and reporting. Filter by past or upcoming times, or search by product, customer, email, phone, or order name.

Connect Appointo 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 Appointo in Metorial. In your Metorial portal, enable the Appointo 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 Appointo tools.

Run Appointo through the Metorial gateway

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

  • Give Appointo and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Appointo 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 Appointo

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.

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.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Google Meet

Create and manage Google Meet meeting spaces, configure access settings, moderation modes, and auto-artifacts like recordings and transcripts. Add, list, and remove space members with roles such as co-host. Retrieve conference records including participant details, join/leave times, and session history. Access meeting artifacts including recording metadata, transcript entries with speaker and timestamp data, and smart notes.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Technical notes for Appointo

Manage appointment bookings and scheduling for Shopify stores. Create, fetch, reschedule, cancel, and update bookings with support for group and multi-day reservations. Retrieve and configure appointment types, check calendar availability for specific date ranges and team members, and manage appointment settings including duration, capacity, buffer times, reminders, and weekly availability slots. Retrieve bookable products/services and subscription contracts.

Frequently asked questions

Common questions about connecting Appointo to AI agents with Metorial.

  1. How many tools does the Appointo MCP server have?
    The Appointo MCP server exposes 11 tools, including Update Appointment Configuration, Reschedule Booking, List Subscription Contracts. Each one is governed and traced through Metorial.
  2. Appointo 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 Appointo MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Appointo and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Appointo MCP server yourself or use the hosted gateway.

Connect Appointo to production AI agents

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