# Nisebookings Booking MCP server

Source: https://glimind.com/server/mcp-registry%2Fcom.nisebookings%2Fbooking
Registry id: `mcp-registry/com.nisebookings/booking`
Status: live (checked 2026-11-22T14:53:00.031Z)

## Measurements (30 days)

- Uptime: 99.85%
- Checks: 1007
- Outages (90 days): 2

## Install

```json
{
  "mcpServers": {
    "nisebookings-booking-mcp-server": {
      "type": "http",
      "url": "https://app.nisebookings.com/api/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http nisebookings-booking-mcp-server https://app.nisebookings.com/api/mcp
```

## Tools (47)

- `add_customer_to_appointment`: Add another booking (customer) to an existing group appointment. Give customerId or customer {name, email, phone}. 409 capacity_exceeded when it does not fit. R
- `add_holiday`: Add a day off. kind: once | yearly (same date every year) | exception (a working day despite company days off). staffId null/omitted = company-wide. Scope catal
- `api_request`: Any /api/v1 management API call not covered by a dedicated tool. path is relative to /api/v1 (e.g. "/services/<uuid>/extras"), ids in place of {…}; put query pa
- `assign_staff_service`: Let a staff member offer a service (create or update the link). Missing fields keep current link values, or for a new link the service price/capacity and deposi
- `create_appointment`: Book like the admin: one appointment with one booking. Give customerId or customer {name, email, phone}. Without end the service duration is used; without statu
- `create_customer`: Create a customer. email is unique per tenant: 409 when it exists, so search with list_customers first. Scope customers:write.
- `create_project`: Create a new account (project) for a client, owned by this account's first owner — the agency case: one login or key configures several client sites. The new ac
- `create_service`: Create a service; missing fields get admin defaults (type simple, duration 60, deposit 100%, taxRate 21). `type` cannot change later. A service is bookable once
- `create_staff`: Create a staff member; the weekly schedule starts as a copy of the business hours. Link services with assign_staff_service afterwards. Scope catalog:write.
- `create_webhook`: Register a URL that receives signed POSTs (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature "v1,<base64 HMAC-SHA256>" over "id.timestamp.body
- `delete_appointment`: Delete an appointment and its bookings. notify: true first sets approved bookings to cancelled and pending ones to rejected and mails the customers. To cancel b
- `delete_holiday`: Remove a day off by id (from list_holidays). Scope catalog:write.
- `delete_webhook`: Delete an endpoint and its delivery log. To pause instead: api_request PATCH /webhooks/{id} {active: false}. New secret: POST /webhooks/{id}/rotate-secret. Scop
- `find_slots`: Bookable times for a service, day by day, exactly as the booking widget sees them (respects schedules, days off, existing bookings, capacity, minimum notice and
- `generate_coupons`: Create up to 100 unique coupon codes from a mask: every * becomes one of 0-9A-Z (e.g. "SUMMER-****"). The other fields are the template for each coupon; discoun
- `get_appointment`: One appointment with bookings (bookingId, status, persons), customers, extras, series/group ids and meetingUrl. Scope bookings:read.
- `get_business_hours`: Company opening hours {days: [{weekday 1=Mon…7=Sun, start, end}]}; a missing weekday = closed. New staff copy these. Scope settings:read.
- `get_customer`: One customer by id. Scope customers:read.
- `get_payment`: One payment with its items and bookings. Mark a local payment paid / refund it via api_request POST /payments/{id}/complete or /refund (payments:write). Scope p
- `get_service`: One service by id. Scope catalog:read.
- `get_settings`: All admin-editable tenant settings, plus read-only id, publicKey (for the widget / public API) and currency. Scope settings:read.
- `get_staff`: One staff member by id. Scope catalog:read.
- `get_staff_schedule`: Weekly working hours of a staff member: {days: [{weekday 1=Mon…7=Sun, start, end, breaks}]}. A missing weekday is a day off. Scope catalog:read.
- `list_appointments`: The calendar: appointments with their bookings and customers. Filter by from/to (ISO date-times; start ≥ from, < to), staffId, serviceId, status (appointments h
- `list_categories`: Service categories, ordered by position. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.
- `list_coupons`: Coupons (discount codes) ordered by code. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.
- `list_customers`: Customers, optionally searched with q (name, e-mail or phone). Scope customers:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.
- `list_events`: Ticketed events ordered by startAt. Ticket types, attendees and event staff are under /events/{id}/… via api_request. Scope catalog:read. Paginated: limit ≤ 100
- `list_holidays`: Days off. staffId filters: a staff id, or "company" for company-wide days; omit for all. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; return
- `list_outbox`: The e-mail log, newest first: what was sent or queued (id, status, toEmail, toName, subject, text, html, createdAt, sentAt, lastError). On a sandbox nothing is 
- `list_payments`: Payments, newest first. Filters: status (pending|completed|rejected|refunded), type (local|free|mollie), customerId. Scope payments:read. Paginated: limit ≤ 100
- `list_services`: All services of the tenant (simple, compound, collaborative, package), ordered by position. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; ret
- `list_staff`: All staff members, including archived ones (visibility = archive). Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.
- `list_staff_services`: Services this staff member offers, with per-link price, capacityMin/Max and deposit. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {d
- `list_webhook_deliveries`: Delivery log of one endpoint, newest first: id, eventId, type, status (pending|sending|delivered|failed), attempts, nextAttemptAt, lastStatus (HTTP), lastError,
- `list_webhooks`: Webhook endpoints (id, url, events, active, description, createdAt, updatedAt); the secret is never returned. Event types with descriptions: api_request GET /we
- `set_business_hours`: Replace ALL business hours (not a merge): one entry per open weekday, no breaks; a missing weekday = closed. Does not change existing staff schedules. Scope set
- `set_staff_schedule`: Replace the WHOLE week of a staff member (not a merge): send every working day; a missing weekday becomes a day off. end > start, breaks inside the day and not 
- `test_webhook`: Queue a `ping` event ({type: "ping", data: {endpointId}}) to the endpoint and send it right away. Returns the delivery (202); check the outcome (status delivere
- `unassign_staff_service`: Stop a staff member offering a service. Existing appointments stay. Scope catalog:write.
- `update_appointment`: Move or change an appointment: send only what changes (start, end, staffId, serviceId, internalNote). start without end keeps the service duration (for a day se
- `update_booking`: Change a booking's status (approve, cancel, reject, done…) and/or persons. id is the bookingId (from create_appointment or get_appointment), not the appointment
- `update_customer`: Partial update of a customer. Scope customers:write.
- `update_service`: Partial update: send only the fields that change (merged over current values). `type` is fixed. Scope catalog:write.
- `update_settings`: Partial update: only fields present are validated and written; returns all settings. id, publicKey and currency are read-only. The Mollie key is set via api_req
- `update_staff`: Partial update of a staff member. visibility "archive" hides them (staff are never deleted). Scope catalog:write.
- `whoami`: The tenant (id, name, timeZone, currency), the scopes of the API key in use and the plan (id, label, bookingsPerMonth, usedThisMonth, level ok|warn|full). Works

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
