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.

read-only

Argument	Type	Description
guests	integer	Number of guests.
customer_id	integer	Your Smoobu user id. Omit to look it up automatically (one extra GET /api/me).
arrival_date*	string	Arrival date (yyyy-mm-dd).
apartment_ids	array	Properties to check. Omit or pass [] to check all.
discount_code	string	Discount code from the booking-tool settings.
departure_date*	string	Departure date (yyyy-mm-dd).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "arrival_date",
    "departure_date"
  ],
  "properties": {
    "guests": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Number of guests."
    },
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Your Smoobu user id. Omit to look it up automatically (one extra GET /api/me).",
      "exclusiveMinimum": 0
    },
    "arrival_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Arrival date (yyyy-mm-dd)."
    },
    "apartment_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "description": "Properties to check. Omit or pass [] to check all."
    },
    "discount_code": {
      "type": "string",
      "description": "Discount code from the booking-tool settings."
    },
    "departure_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure date (yyyy-mm-dd)."
    }
  }
}

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 /api/reservations.

destructive

Argument	Type	Description
email	string	Guest email.
phone	string	Guest phone.
price	number	Total price of the booking.
adults	integer	Number of adults.
notice	string	Free-text notes on the booking.
address	object	Guest address.
country	string	Guest country.
deposit	number	Deposit amount.
children	integer	Number of children.

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}.

read-only

Argument	Type	Description
apartment_id*	integer	The apartment (property) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "apartment_id"
  ],
  "properties": {
    "apartment_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The apartment (property) id.",
      "exclusiveMinimum": 0
    }
  }
}

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}.

read-only

Argument	Type	Description
guest_id*	integer	The guest id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "guest_id"
  ],
  "properties": {
    "guest_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The guest id.",
      "exclusiveMinimum": 0
    }
  }
}

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.

read-only

Argument	Type	Description
end_date*	string	Last date (yyyy-mm-dd).
start_date*	string	First date (yyyy-mm-dd).
apartment_ids*	array	Property ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "apartment_ids",
    "start_date",
    "end_date"
  ],
  "properties": {
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last date (yyyy-mm-dd)."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First date (yyyy-mm-dd)."
    },
    "apartment_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "minItems": 1,
      "description": "Property ids."
    }
  }
}

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}.

read-only

Argument	Type	Description
reservation_id*	integer	The reservation (booking) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id"
  ],
  "properties": {
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    }
  }
}

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.

read-only

Argument	Type	Description
reservation_id*	integer	The reservation (booking) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id"
  ],
  "properties": {
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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}].

read-only

Argument	Type	Description
apartment_id	integer	Only add-ons for this property.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "apartment_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only add-ons for this property.",
      "exclusiveMinimum": 0
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

smoobu_list_guests

List guests from the Smoobu CRM with their emails, phone numbers, address, notes and bookings; optionally search. Smoobu: GET /api/guests.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
query	string	Search term, e.g. a name or email.
page_size	integer	Guests per page, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "query": {
      "type": "string",
      "description": "Search term, e.g. a name or email."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Guests per page, 1-100."
    }
  }
}

smoobu_list_message_threads

List the unified guest inbox: one thread per booking with guest name, property and the latest message, plus the unread count. Smoobu: GET /api/threads.

read-only

Argument	Type	Description
page_size	integer	Threads per page.
page_number	integer	Page number, starting at 1.
apartment_ids	array	Only threads for these properties.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Threads per page."
    },
    "page_number": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "apartment_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "description": "Only threads for these properties."
    }
  }
}

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.

read-only

Argument	Type	Description
reservation_id*	integer	The reservation (booking) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id"
  ],
  "properties": {
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    }
  }
}

smoobu_list_reservation_messages

Get the full conversation for one reservation, paginated. Each message has a subject, plain-text and HTML body, and type (1 = inbox / from guest, 2 = outbox / sent). Smoobu: GET /api/reservations/{reservationId}/messages.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
reservation_id*	integer	The reservation (booking) id.
only_related_to_guest	boolean	true = only guest-facing messages; false = every message on the booking.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    },
    "only_related_to_guest": {
      "type": "boolean",
      "description": "true = only guest-facing messages; false = every message on the booking."
    }
  }
}

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.

read-only

Argument	Type	Description
to	string	End of that stay range (yyyy-mm-dd).
from	string	Only bookings overlapping a stay range starting on this date (yyyy-mm-dd).
page	integer	Page number, starting at 1.
page_size	integer	Bookings per page, 1-100.
arrival_to	string	Only arrivals on or before (yyyy-mm-dd).
created_to	string	Only bookings created on or before (yyyy-mm-dd).
modified_to	string	Only bookings modified on or before (yyyy-mm-dd).
apartment_id	integer	Only this property.
arrival_from	string

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.

destructive

Argument	Type	Description
subject	string	Subject line.
message_body*	string	Message content, HTML or plain text.
reservation_id*	integer	The reservation (booking) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id",
    "message_body"
  ],
  "properties": {
    "subject": {
      "type": "string",
      "description": "Subject line."
    },
    "message_body": {
      "type": "string",
      "minLength": 1,
      "description": "Message content, HTML or plain text."
    },
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    }
  }
}

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.

destructive

Argument	Type	Description
subject	string	Subject line.
internal	boolean	true = visible only to the host, hidden from the guest.
message_body*	string	Message content, HTML or plain text.
reservation_id*	integer	The reservation (booking) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reservation_id",
    "message_body"
  ],
  "properties": {
    "subject": {
      "type": "string",
      "description": "Subject line."
    },
    "internal": {
      "type": "boolean",
      "description": "true = visible only to the host, hidden from the guest."
    },
    "message_body": {
      "type": "string",
      "minLength": 1,
      "description": "Message content, HTML or plain text."
    },
    "reservation_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The reservation (booking) id.",
      "exclusiveMinimum": 0
    }
  }
}

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 /api/rates.

destructive

Argument	Type	Description
operations*	array	Rate changes to apply.
apartment_ids*	array	Property ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "apartment_ids",
    "operations"
  ],
  "properties": {
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "dates"
        ],
        "properties": {
          "dates": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}(:\\d{4}-\\d{2}-\\d{2})?$"
            },
            "minItems": 1,
            "description": "Single dates 'yyyy-mm-dd' or ranges 'yyyy-mm-dd:yyyy-mm-dd'."
          },
          "daily_price": {
            "type": "number",
            "description": "Nightly price.",
            "exclusiveMinimum": 0
          },
          "min_length_of_stay": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 1,
            "description": "Minimum nights."
          }
        }
      },
      "minItems": 1,
      "description": "Rate changes to apply."
    },
    "apartment_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "minItems": 1,
      "description": "Property ids."
    }
  }
}

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}.

destructive

Argument	Type	Description
price	number	Total price.
adults	integer	Number of adults.
notice	string	Free-text notes on the booking.
deposit	number	Deposit amount.
children	integer	Number of children.
language	string	Guest language, e.g. en, de, es.
guest_name	string	Guest name.
prepayment	number	Prepayment amount.
guest_email	string	Guest email.
guest_phone

Smoobu MCP by usefulapi

Try it

smoobu_check_availability Read-only

Smoobu MCP by usefulapi

Try it

smoobu_check_availability Read-only

Tools (20)