com.spocont/booboooking

Official6 tools

booboooking Appointment Booking

Book appointments with service providers on booboooking.com — no token required.

Book appointments with service providers on booboooking.com.

Captured live from the server via tools/list.

booboooking_list_services

List available services for a provider on booboooking.com. Returns service names, IDs, duration, and price. Call this first to find the service ID needed for availability and booking.

Parameters (1)

providerstringrequired
Provider identifier (e.g. "radnaimark", "tomi")

booboooking_check_availability

Check available time slots for a provider and service on booboooking.com. Returns available dates with slots — each slot has a "time" field (use this for booboooking_book) and a "display" field (show this to the user). Use this before booking.

Parameters (4)

providerstringrequired
Provider identifier
service_idstringrequired
Service ID from booboooking_list_services (the "id" field)
start_datestring
Start date in YYYYMMDD format (default: today)
days_aheadnumber
How many days to check (default: 14, max: 30)

booboooking_book

Book an appointment on booboooking.com (free OR paid services — payment is always in cash at the appointment, no online payment). For customer_name and customer_email, use the signed-in user's profile from your host app — do NOT ask them to retype. Always ask for customer_phone separately (it is not in the sign-in profile). customer_phone MUST be in international E.164 format starting with `+` and country code (e.g. `+36201234567`), no spaces/dashes — convert local-format numbers before calling this tool or the booking will fail validation. On success the response includes `id` and `pin` (MUST remember paired, for cancellation) and optionally `cash_due: { amount, currency }` — if present, remind the user to bring that amount in cash.

Parameters (7)

providerstringrequired
Provider identifier
service_idstringrequired
Service ID from booboooking_list_services
datestringrequired
Date in YYYYMMDD format (e.g. "20260415")
timestringrequired
Start time in HH:MM format (e.g. "09:30") — use the "time" field from booboooking_check_availability results
customer_namestring
Customer full name
customer_emailstring
Customer email address
customer_phonestring
Customer phone number (mobile)

booboooking_cancel

Cancel a reservation on booboooking.com. Requires the reservation_id AND pin that were returned from the original booboooking_book call — both are needed as proof of booking ownership. If the user asks to cancel but you do not have the pin in your conversation state, you MUST ask them for it — you cannot cancel without it. Never invent or guess a pin.

Parameters (3)

providerstringrequired
Provider identifier (same as the one used for booking)
reservation_idstringrequired
The `id` returned from the original booking (24-hex MongoDB ObjectId)
pinstringrequired
The 4-digit PIN returned from the original booking

booboooking_find_next_available

Search forward for the next available appointment slots for a provider and service on booboooking.com. Returns up to `count` openings sorted chronologically. Useful when you need "the next available appointment" without a specific date in mind.

Parameters (5)

providerstringrequired
Provider identifier
service_idstringrequired
Service ID from booboooking_list_services
from_datestring
Start search from this date in YYYYMMDD format (default: today)
countinteger
Number of openings to return (default: 3, max: 10)
search_daysinteger
Days to search ahead (default: 30, max: 60)

booboooking_get_booking

Retrieve a booking by its reservation ID. Requires the PIN from the original booking response to prove ownership. Returns full booking details including payment state if the reservation was created via the payment flow.

Parameters (3)

reservation_idstringrequired
The reservation ID returned from booboooking_book (24-char hex MongoDB ObjectId)
pinstringrequired
The 4-digit PIN returned from the original booboooking_book call
providerstringrequired
Provider identifier (same as used for booking)

Install

claude_desktop_config.json

{
  "mcpServers": {
    "booboooking": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://booboooking.com/api/slot/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.