Customer Relation

Cloudbeds MCP Server

Connect your account, then chat with AI to run tools.

Cloudbeds is a hospitality property management system for hotels, hostels, and vacation rentals. Read and write reservations, guests, folios, rates, housekeeping, and inventory across one or many properties.

Managed
61 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Cloudbeds — workflow patterns, data models, and gotchas for your AI agent.

Cloudbeds

Property management for hotels and vacation rentals. One connected account can span many properties under an organization.

Hierarchy

Organization → Properties (propertyID) → Room types → Physical rooms → Reservations → Guests → Folio lines.

Channel bookings (Airbnb, Expedia, website, etc.) land as reservations with sourceName and sourceID. Airbnb-synced stays appear as sources like Airbnb (API) — there is no separate Airbnb API in this bundle.

Operational order

  1. Discover scope — enumerate properties, then pick a propertyID for all property-scoped reads.
  2. Daily pulse — dashboard snapshot for occupancy, arrivals, departures, and in-house counts.
  3. Channel triage — list booking sources at the property, then filter reservations by sourceID (not sourceName).
  4. Stay lookup — reservation lists with date/status filters; single-booking detail or folio invoice when you have reservationID.
  5. Availability & rates — room-type availability for a stay window (counts + quoted rates), or rate-plan calendar across a date range. Use the rate-detail reservation list when you need per-night lines on existing bookings.
  6. Guest & folio — guest profiles, folio transactions, and recorded payments scoped to a reservation.

What this bundle covers

NeedAPI surface
Multi-property portfolioProperty list + per-property detail
Today's opsDashboard occupancy and arrival counts
OTA / direct bookingsReservations + source channel list
Airbnb / Expedia visibilityFilter reservations by channel sourceID
Availability searchRoom types with roomsAvailable for a date range
Rate calendarNightly rate plans across dates
Per-booking revenue detailReservations with room rate breakdowns
Folio / invoiceRoom charges, adjustments, payments on one reservation
InventoryRoom types, physical rooms, blocks, housekeeping status
POS extrasProperty item catalog (sku, price)

Write operations

All writes use application/x-www-form-urlencoded bodies. Nested arrays (rooms on create, rate intervals) pass as structured list parameters — use extra_fields for rarely used upstream keys.

AreaCapabilities
ReservationsCreate/update bookings, notes, documents, room assign, check-in/out
GuestsAdd/update profiles, notes, documents, assign to rooms
FolioPost items, adjustments, payments, void lines
RatesQueue nightly rate updates (putRate is asynchronous)
InventoryRoom blocks, housekeeping status and assignments
Groups & accountsGroup profiles, house accounts, webhooks

High-impact writes (real folio or PMS rows): reservation create, payment record, item post, rate update, check-in/out. Confirm intent before calling.

Token scopes: Writes need matching write:* scopes on the API key. Read-only tokens fail with permission errors.

Not available via Cloudbeds API

  • Guest messaging (Airbnb/OTA inbox) — not exposed.
  • Listing reviews or ranking metrics — channel marketing data stays on the OTA.
  • Native Airbnb API — partner-gated; synced reservations are the supported path.

Gotchas

  • Always scope by property: Unscoped reservation lists can return tens of thousands of rows.
  • Single-record reads need propertyID: Guest and reservation detail endpoints reject calls without it.
  • Source filter casing: Live API expects sourceID (capital ID), not the sourceId spelling in some docs.
  • Rate plans need both dates: startDate and endDate are required.
  • Payment lists need a scope: Pass reservationID, guestID, or houseAccountID — property alone is not enough. guestID is the fastest filter; reservationID ledger reads can take 30–75 seconds.
  • Transaction lists are slow without reservationID: Property-wide folio history can exceed 60 seconds — always pass reservationID from a reservation list when you have it.
  • Physical rooms are nested upstream: get_rooms returns a flat rooms array plus physical_room_count in addition to the raw property blocks.
  • Pagination: Default page size is modest; filter before paging deep into large accounts.

Tools in this Server (61)

Cloudbeds Delete Adjustment

Void an adjustment transaction on a reservation folio.

Cloudbeds Delete Allotment Block

Delete an allotment block on a property.

Cloudbeds Delete App Property Settings

Remove app integration settings for a property.

Cloudbeds Delete Guest Note

Archive a guest note.

Cloudbeds Delete Reservation Note

Archive a reservation note.

Cloudbeds Delete Room Block

Delete a room block / out-of-order hold.

Cloudbeds Delete Webhook

Unsubscribe a webhook subscription.

Cloudbeds Get Available Room Types

Search sellable room types for a stay window with live availability counts and quoted nightly rates. Requires property_id, start_date, end_date (YYYY-...

Cloudbeds Get Dashboard

Return today's operational snapshot for a property: occupancy, arrivals, departures, guests in-house, and booking counts. Optional date (YYYY-MM-DD) s...

Cloudbeds Get Guests

List guests at a property or fetch one guest profile. Pass guest_id or reservation_id with property_id for a single guest; omit both ids to list guest...

Cloudbeds Get Hotels

List Cloudbeds properties (hotels) on the connected account, or fetch one property's details when property_id is set. Always start here to discover pr...

Cloudbeds Get Housekeeping Status

List housekeeping status for physical rooms at a property: clean/dirty condition, occupancy, do-not-disturb, and room comments. Requires property_id.

Cloudbeds Get Items

List point-of-sale items (extras, minibar, fees) configured at a property with sku, price, and category. Requires property_id.

Cloudbeds Get Payments

List payments recorded against a reservation, guest, or house account. At least one of reservation_id, guest_id, or house_account_id is required along...

Cloudbeds Get Rate Plans

List rate plans and nightly rates for a property across a date range. Requires property_id plus start_date and end_date (YYYY-MM-DD).

Cloudbeds Get Reservation Invoice

Fetch folio-style invoice detail for one reservation: room charges, adjustments, payments, add-ons, and guest custom fields. Requires property_id and ...

Cloudbeds Get Reservations

List or fetch Cloudbeds reservations. Pass reservation_id with property_id for one booking; omit reservation_id to list. Always set property_id when l...

Cloudbeds Get Reservations With Rate Details

List reservations with per-room nightly rate breakdowns (detailedRates). Same filters as the standard reservation list but heavier payloads — use when...

Cloudbeds Get Room Blocks

List room blocks (inventory holds / out-of-order rooms) at a property. Requires property_id.

Cloudbeds Get Rooms

List physical room inventory at a property (distinct from room types). Upstream nests rooms under property blocks; this tool also returns a flat rooms...

Cloudbeds Get Room Types

List room types (categories) configured at a Cloudbeds property. Requires property_id.

Cloudbeds Get Sources

List booking sources (channels) for one or more properties — website, Airbnb, Expedia, and other OTAs. Use source_id values when filtering reservation...

Cloudbeds Get Transactions

List folio transactions (charges, payments, adjustments) at a property. Requires property_id. Strongly prefer reservation_id — property-wide lists can...

Cloudbeds Post Adjustment

Add a manual folio adjustment to a reservation (credit or charge correction). Requires property_id, reservation_id, amount, and adjustment type fields...

Cloudbeds Post App Property Settings

Create app integration settings for a property.

Cloudbeds Post Charge

Process a gateway charge on a reservation, group, house account, or AR ledger. Consumes real payment processing — use only when the guest should be ch...

Cloudbeds Post Custom Field

Register a new custom field definition on the property (one-time setup). Does not set values on reservations — use reservation update for that.

Cloudbeds Post Custom Item

Post one or more ad-hoc item lines (and optional payments) to a folio in one call.

Cloudbeds Post Custom Payment Method

Add a custom payment method type to the property (not card/PayPal).

Cloudbeds Post File

Attach a file to a property record.

Cloudbeds Post Government Receipt

Attach a government receipt to a reservation or house account.

Cloudbeds Post Group Note

Add a note to a group profile.

Cloudbeds Post Guest

Add an additional guest to an existing reservation.

Cloudbeds Post Guest Document

Attach a document file to a guest profile.

Cloudbeds Post Guest Photo

Attach a photo to a guest profile.

Cloudbeds Post Guests To Room

Assign one or more guests to a room on a reservation.

Cloudbeds Post House Account

Open a new house account on the property.

Cloudbeds Post Housekeeping Assignment

Assign rooms to a housekeeper for the current day.

Cloudbeds Post Housekeeping Status

Mark a physical room clean, dirty, inspected, DND, or out-of-order for today.

Cloudbeds Post Item

Post a catalog item charge to a reservation, house account, or group folio.

Cloudbeds Post Item Category

Add a POS item category on the property.

Cloudbeds Post Items To Inventory

Add multiple stock-tracked items to property inventory.

Cloudbeds Post Payment

Record a payment on a reservation, house account, or group. Requires property_id plus one of reservation_id, house_account_id, or group_code.

Cloudbeds Post Reservation Document

Attach a document to a reservation.

Cloudbeds Post Room Assign

Assign or reassign a physical room on a reservation room line.

Cloudbeds Post Room Check In

Check in an assigned room on a reservation.

Cloudbeds Post Room Check Out

Check out an assigned room. When all rooms check out, reservation status updates to checked out.

Cloudbeds Post Void Item

Void a posted item line on a reservation, house account, or group.

Cloudbeds Post Void Payment

Void a recorded payment on a reservation or house account.

Cloudbeds Post Webhook

Subscribe to a Cloudbeds webhook event for the property.

Cloudbeds Put App Property Settings

Update app integration settings for a property.

Cloudbeds Put Group

Create a group/event profile on the property.

Cloudbeds Put Guest

Update an existing guest profile. At least one profile field beyond ids is required.

Cloudbeds Put House Account Status

Open or close a house account.

Cloudbeds Put Item To Inventory

Update a stock-tracked inventory item.

Cloudbeds Put Rate

Queue nightly rate updates for a rate plan. Returns a job reference id — updates are asynchronous. Only non-derived rates can be changed. Max 30 date ...

Cloudbeds Upsert Guest Note

Add a guest note (omit note_id) or update an existing guest note (set note_id).

Cloudbeds Upsert Housekeeper

Add a housekeeper (omit housekeeper_id) or update housekeeper details (set housekeeper_id).

Cloudbeds Upsert Reservation

Create a reservation (omit reservation_id) or update an existing one (set reservation_id). Creates need property_id, stay dates, guest name, and rooms...

Cloudbeds Upsert Reservation Note

Add a reservation note (omit note_id) or update an existing note (set note_id).

Cloudbeds Upsert Room Block

Create a room block / out-of-order hold (omit room_block_id) or update one (set room_block_id).

Frequently Asked Questions

What is the Cloudbeds MCP server?

Cloudbeds is a hospitality property management system for hotels, hostels, and vacation rentals. Read and write reservations, guests, folios, rates, housekeeping, and inventory across one or many properties. It provides 61 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Cloudbeds to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/cloudbeds. Authentication is handled automatically.

How many tools does Cloudbeds provide?

Cloudbeds provides 61 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Cloudbeds require?

Cloudbeds uses API Key. Cloudbeds requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Cloudbeds to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/cloudbeds

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Cloudbeds and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Cloudbeds will appear under Not connected — select it and click Connect to complete OAuth.
Name: Cloudbeds
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/cloudbeds
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Cloudbeds?

Sign in to connect your credentials and start running tools from the chat.

Cloudbeds MCP Server & Skill