# Smoobu MCP by usefulapi

> Smoobu MCP by usefulapi is an MCP server. Check vacation-rental reservations, rates, availability and guest messages, and update bookings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/smoobu/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smoobu
- **MCP Registry name:** io.usefulapi/smoobu
- **Listing updated:** 2026-11-13

## About

Check vacation-rental reservations, rates, availability and guest messages, and update bookings.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `smoobu_get_user`: Fetch the Smoobu user these credentials belong to (id, name, email). A cheap way to confirm the setup works; the id is the customerId used by availability checks. Smoobu: GET /api/me.
- `smoobu_list_apartments`: List every property (Smoobu calls them apartments) in the account, with id and name. Start here to get apartment ids. Smoobu: GET /api/apartments.
- `smoobu_get_apartment`: Fetch one property's details: location, time zone, rooms and beds, max occupancy, amenities, currency, min/max nightly price and type. Smoobu: GET /api/apartments/{apartmentId}.
- `smoobu_list_reservations`: List reservations across all channels (Airbnb, Booking.com, direct, ...), paginated, with guest, dates, channel, price and payment status. Filter by stay range, arrival, departure, creation or modification date, and property. Smoobu: GET /api/reservations.
- `smoobu_get_reservation`: Fetch one reservation by id: guest, dates, check-in/out times, channel and its reference id, price, prepayment and deposit status, and the guest-app URL. Smoobu: GET /api/reservations/{reservationId}.
- `smoobu_list_price_elements`: List the financial breakdown of one reservation: base price, cleaning fee, add-ons, long-stay discounts and coupons, with amounts, tax and currency. Smoobu: GET /api/reservations/{reservationId}/price-elements.
- `smoobu_get_reservation_placeholders`: Get every placeholder value Smoobu would substitute into a message for this reservation: guest name, dates and times, nights, price and balance, online check-in link, guest-app link, door PIN codes and more. Useful for drafting a guest message. Smoobu: GET /api/reservations/{reservationId}/placeholders.
- `smoobu_get_rates`: Get the nightly price, minimum length of stay and availability (0 = not available) for each date in a range, for one or more properties. Smoobu: GET /api/rates.
- `smoobu_check_availability`: Check which properties can be booked for an arrival/departure pair and get the total price for each; unavailable ones come back with the reason (minimum stay, too many guests, arrival day, lead time...). Read-only, books nothing. Smoobu: POST /booking/checkApartmentAvailability.
- `smoobu_list_message_threads`: List the unified guest inbox: booking.guest_name, latest_message.subject, latest_message.text_content and latest_message.html_content, plus property and unread count. Read HTML when plain text is empty. Guest names and messages require Guest Data (PII) enabled for the key; missing upstream content is not reconstructed. Smoobu: GET /api/threads.
- `smoobu_get_conversation`: Read one reservation and one page of its actual messages directly, rather than relying on an inbox thread's latest-message summary. Returns the guest name from the reservation and unmodified message subject, plain-text and HTML fields with pagination. If the reservation name is blank and it identifies a guest, also checks that guest's documented profile for a name. Uses only this connection's perm
- `smoobu_list_reservation_messages`: Get a reservation's conversation, paginated, preserving subject, message (plain text), messageHtml/htmlMessage (HTML), and type (1 = inbox / from guest, 2 = outbox / sent). Read HTML when message is empty. Guest names are on smoobu_get_reservation (guest-name) or smoobu_list_message_threads (booking.guest_name), not this endpoint; Guest Data (PII) must be enabled for the key. Missing upstream cont
- `smoobu_list_guests`: List guests from the Smoobu CRM with their emails, phone numbers, address, notes and bookings; optionally search. Smoobu: GET /api/guests.
- `smoobu_get_guest`: Fetch one guest by id (the guestId on a reservation) with contact details, notes and every booking they have made. Smoobu: GET /api/guests/{guestId}.
- `smoobu_list_addons`: List the bookable add-ons (towels, breakfast, late check-out...) with amount, tax, calculation type (0 per booking, 1 per person, 2 per night, 3 per person and night) and the properties they apply to; optionally for one property. Smoobu: GET /api/addons[/{apartmentId}].
- `smoobu_list_custom_placeholders`: List the account's custom message placeholders (key, default value, and whether they are global, per booking or per property). Smoobu: GET /api/custom-placeholders.
- `smoobu_create_reservation`: Create a reservation (or a blocked period) on a property. Smoobu treats it like a booking from a channel and SYNCS the blocked dates to every connected channel (Airbnb, Booking.com, ...). Fails if the dates overlap an existing booking. This server offers no cancel — cancel it in Smoobu if needed. Which guest fields are mandatory depends on your booking-tool 'Form Content' settings. Smoobu: POST /a
- `smoobu_update_reservation`: Update an existing reservation's times, guest contact, notes, guest counts, language, or price / prepayment / deposit amounts and paid status. Only the fields you pass are sent. Dates and property cannot be changed here. Smoobu: PUT /api/reservations/{reservationId}.
- `smoobu_set_rates`: Set the nightly price and/or minimum length of stay for dates on one or more properties. Smoobu PUSHES these to every channel with price sync enabled, so this changes live prices guests see. Reversible by setting the old values again — read them first with smoobu_get_rates. Each operation needs daily_price, min_length_of_stay, or both (a minimum stay alone needs an existing price). Smoobu: POST /a
- `smoobu_send_message_to_guest`: Send a message to the guest of a reservation through Smoobu (it goes out on the booking's channel, e.g. the Airbnb or Booking.com inbox, or email). Delivered IMMEDIATELY and cannot be unsent — confirm the text with the user first. Smoobu: POST /api/reservations/{reservationId}/messages/send-message-to-guest.
- `smoobu_send_message_to_host`: Post a message on a reservation's thread addressed to the Smoobu user (the host). With internal=true it is an internal note hidden from the guest — handy for logging. Cannot be unsent. Smoobu: POST /api/reservations/{reservationId}/messages/send-message-to-host.

## FAQ

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

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

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