# Appointo MCP by usefulapi

> Appointo MCP by usefulapi is a freemium MCP server for e-commerce. Hosted MCP server for Shopify merchants to manage Appointo bookings from chat. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/appointo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/appointo
- **MCP Registry name:** io.usefulapi/appointo
- **Categories:** e-commerce, local services
- **Listing updated:** 2026-11-15

## About

Built for Shopify stores that sell appointments through Appointo, this connector lists upcoming, past or searched bookings with time, product, duration, quantity, price and the customer's name, email and phone. It separates bookable products from their services and reads the open time slots of one service from a start date.

Writes cover the full lifecycle: create a booking in an open slot (Appointo may email the customer), reschedule it, cancel it or only some of its customers, and set the minutes blocked before and after it. A separate tool lists subscription contracts for customers who repeat appointments, searchable by product, variant, order number or customer name, and another lists cancelled bookings.

You paste an Appointo API token on the OAuth login page. Token access sits under Plans & Settings, API access, and is available on paid Appointo plans.

## Features

- **Booking search:** Lists upcoming, past or searched bookings with customer contact details.
- **Open slot lookup:** Reads open time slots for a service from a start date.
- **Create and reschedule:** Books a customer into an open slot or moves an existing booking.
- **Partial cancellation:** Cancels a booking or only selected customers on it.
- **Buffer times:** Sets minutes blocked before and after a booking.
- **Subscription contracts:** Lists recurring-appointment contracts by product, variant, order or customer.

## Good for

- See tomorrow's bookings and customers
- Move booking 969 to Thursday afternoon
- Review this month's cancellations
- Find free slots for a 60-minute consultation
- Check recurring appointment subscriptions

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http appointo https://appointo.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://appointo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "appointo": {
      "url": "https://appointo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "appointo": {
      "type": "http",
      "url": "https://appointo.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "appointo": {
      "serverUrl": "https://appointo.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "appointo": {
      "type": "http",
      "url": "https://appointo.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `appointo_list_products`: List the Shopify products that are set up as bookable in Appointo: name, appointment type, whether the widget is shown, and each product's appointments (the bookable variants/services with price, currency and id). Use an appointment id for availability and bookings. GET /products.
- `appointo_list_appointments`: List appointments, i.e. the bookable services/variants, with name, price, currency and configuration. Filter by product or fetch one by id. These are the services customers book, not the bookings themselves (use appointo_list_bookings for those). GET /appointments.
- `appointo_get_availability`: The free time slots of one appointment (bookable service) from start_date, optionally to end_date. Use it before creating or rescheduling a booking. GET /appointments/{appointment_id}/calendar_availability.
- `appointo_list_bookings`: List bookings with time, product, duration, quantity, price and the customers (name, email, phone, address). Filter upcoming/past or search; pass booking_id for one booking. The customers' cancel/reschedule link ids are never returned. GET /bookings.
- `appointo_list_cancelled_bookings`: List cancelled bookings, same shape as appointo_list_bookings. GET /bookings/cancelled_bookings.
- `appointo_list_subscription_contracts`: List the recurring booking subscription contracts (customers who subscribed to repeat appointments). Search by product, variant, order number or customer name. The API documents no paging for this list. GET /appointment_subscriptions.
- `appointo_create_booking`: WRITE: create a booking for a customer on an appointment (bookable service) at a time slot. This is a real booking: Appointo may email the customer a confirmation and reserve the slot; the booking can later be cancelled with appointo_cancel_booking. Check appointo_get_availability first. Not idempotent: calling twice creates two bookings. The docs cap this at 100 requests per day. POST /bookings.
- `appointo_reschedule_booking`: WRITE: move a booking (or only some of its customers) to a new time slot. Appointo may notify the customers of the change. override=true forces the booking into the slot even if it is unavailable or full, so leave it off unless the user explicitly asked for it. The docs cap this at 100 requests per day. PUT /bookings/reschedule.
- `appointo_cancel_booking`: WRITE: cancel a booking, or only some of its customers. The slot is freed and Appointo may notify the customers; whether a Shopify order is refunded is not controlled by this call. Cannot be undone through this server (create a new booking instead). The docs cap this at 100 requests per day. PUT /bookings/cancel.
- `appointo_update_booking_buffers`: WRITE: set the start and/or end buffer time (minutes blocked before/after) of one booking. At least one value is required. The docs cap this at 100 requests per day. PUT /bookings/{booking_id}.

## FAQ

### Which Appointo plan includes API access?

API access is available on paid Appointo plans; find the token under Plans & Settings, API access.

### Will the customer be emailed?

Creating a booking may trigger an email from Appointo to the customer.

### Is Appointo MCP by usefulapi free?

Appointo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Appointo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http appointo https://appointo.usefulapi.io/mcp

### What are the best alternatives to Appointo MCP by usefulapi?

The closest alternatives to Appointo MCP by usefulapi are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Later Stages and Virkly CVR.

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/appointo-mcp-by-usefulapi
