# Bookafy MCP by usefulapi

> Bookafy MCP by usefulapi is a freemium MCP server for time tracking. Hosted MCP server that lets AI assistants review and manage Bookafy appointments. 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, Web, vscode
- **Website:** https://usefulapi.io/bookafy/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bookafy
- **MCP Registry name:** io.usefulapi/bookafy
- **Categories:** time tracking
- **Listing updated:** 2026-11-18

## About

The Bookafy connector is a hosted remote server that sits between an AI client and the Bookafy API, so you can read staff calendars, look up customers and services, and make changes to bookings using plain-language requests. Access is granted by logging in with your own Bookafy API key through an OAuth-style page, and the server only sees what that account can see.

The server exposes 19 tools. Ten are read-only, covering appointments, customers, services, appointment types with public booking links, staff, classes and webhook subscriptions. Five write tools can create, reschedule or cancel appointments and create or update customers. The README notes that cancellations cannot be restored through the API and that Bookafy may notify customers, so most clients will ask for approval before a write runs.

It is aimed at service businesses that run staff calendars and customer bookings in Bookafy and want to query them from Claude, ChatGPT, Cursor, VS Code or other MCP-compatible clients. The page states that usefulapi is an independent service and is not affiliated with or endorsed by Bookafy.

## Features

- **Staff calendar review:** Lists one staff member's appointments within an optional UTC date range, including customer, service and status.
- **Customer lookup:** Searches customers by name, email or phone and returns their contact details.
- **Booking links:** Returns appointment types grouped by category with public booking-page links to share with customers.
- **Appointment changes:** Creates, reschedules or cancels appointments, with write tools that clients can ask the user to confirm.
- **Class and session data:** Reads classes, sessions, seat counts and attendees for group offerings.
- **Usage metering:** Reports calls used against the monthly plan limit and supports upgrading or cancelling the paid plan.

## Good for

- Check which appointments a staff member has during a given week
- Send a customer the self-booking link for a specific service
- Find a customer record by email before making a booking
- Reschedule an existing appointment after a client asks for a new time
- Review class attendees and remaining seats for a session

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `bookafy_get_account`: The account this API key belongs to: the admin user's email.
- `bookafy_list_appointments`: List the appointments of one staff member, optionally within a UTC date range.
- `bookafy_create_appointment`: Book an appointment for a customer with a staff member and service.
- `bookafy_update_appointment`: Reschedule or edit an existing appointment.
- `bookafy_cancel_appointment`: Cancel an appointment; irreversible through the API.
- `bookafy_list_customers`: List the account's customers with search and paging.
- `bookafy_create_customer`: Add a customer record without booking anything.
- `bookafy_update_customer`: Change a customer's details.
- `bookafy_list_services`: List every service with id, price, duration and options.
- `bookafy_list_appointment_types`: List appointment types grouped by category with public booking links.
- `bookafy_list_staff`: List staff users with id, name, email and booking-page URL.
- `bookafy_list_classes`: List classes and one-off appointments with sessions and seats.
- `bookafy_get_class`: Get one class with its sessions and attendees.
- `bookafy_list_session_attendees`: List the attendees of one class session.
- `bookafy_list_webhooks`: List webhook subscriptions.
- `bookafy_usage_status`: Report current usage against the plan limit.
- `bookafy_request_feature`: Send a request for a feature the tools cannot yet provide.
- `bookafy_upgrade`: Get a paid Pro or Pro+ plan payment link or change an existing plan.
- `bookafy_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Bookafy product?

No. The page says usefulapi is an independent service and is not affiliated with or endorsed by Bookafy.

### What do I need to connect?

The login page asks for your Bookafy API key, which the page says is found under Settings → Integrations for an admin user. API access depends on your Bookafy plan.

### What does it cost?

The Free plan gives 50 tool calls per month. Pro is $9/mo or $90/yr for 10,000 calls per month, and Pro+ is $39/mo or $390/yr for 100,000 calls per month. Each subscription covers this server only.

### Can the AI change my Bookafy data?

Yes, if you approve it. Five of the 19 tools can create or change data; the rest are read-only or meta tools.

### Is Bookafy MCP by usefulapi free?

Bookafy 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 Bookafy MCP by usefulapi to Claude Code?

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

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

The closest alternatives to Bookafy MCP by usefulapi are TotemClock MCP by usefulapi, TimeStation MCP by usefulapi, ROLLER MCP by usefulapi, Staffwise MCP by usefulapi and TimeTrex MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TotemClock MCP by usefulapi](https://ai-powered.com/mcp/totemclock-mcp-by-usefulapi): TotemClock MCP by usefulapi is a freemium MCP server for hiring and recruiting.
- [TimeStation MCP by usefulapi](https://ai-powered.com/mcp/timestation-mcp-by-usefulapi): TimeStation MCP by usefulapi is a freemium MCP server for hr and payroll.
- [ROLLER MCP by usefulapi](https://ai-powered.com/mcp/roller-mcp-by-usefulapi): ROLLER MCP by usefulapi is a freemium MCP server for time tracking.
- [Staffwise MCP by usefulapi](https://ai-powered.com/mcp/staffwise-mcp-by-usefulapi): Staffwise MCP by usefulapi is a freemium MCP server for time tracking.
- [TimeTrex MCP by usefulapi](https://ai-powered.com/mcp/timetrex-mcp-by-usefulapi): TimeTrex MCP by usefulapi is a freemium MCP server for time tracking.
- [Timicx MCP by usefulapi](https://ai-powered.com/mcp/timicx-mcp-by-usefulapi): Timicx MCP by usefulapi is a freemium MCP server for time tracking.
- [Timetaag MCP by usefulapi](https://ai-powered.com/mcp/timetaag-mcp-by-usefulapi): Timetaag MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Paydirt MCP by usefulapi](https://ai-powered.com/mcp/paydirt-mcp-by-usefulapi): Paydirt MCP by usefulapi is a freemium MCP server for time tracking.

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