Beds24 MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.1Updated Nov 14, 2026

Check bookings, quote stays, read guest messages and reviews, and update calendars in Beds24.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted Beds24 connector that lets an assistant check bookings, quote stays, read guest messages and reviews, and update room calendars.

What you can do
  • Check the token and list properties with room types and settings
  • Search and read bookings, invoices and guest conversations across channels
  • Quote stays and inspect availability, unit occupancy, calendars and fixed price rules
  • Read Booking.com and Airbnb guest reviews
  • Create or update bookings, send guest messages, mark messages read and change room calendar values
  • Report usage and manage the paid subscription plan
When to use it
Useful for hosts and property managers who want to ask an assistant about arrivals, availability and pricing, catch up on unread guest messages and reviews, or adjust calendars and bookings without opening Beds24.
Requirements
Remote MCP endpoint connected by URL only; sign-in is via OAuth, and the login page asks for a Beds24 invite code or a refresh or read-only long life token from the Beds24 API settings. No API key or Authorization header goes in the client config. Free plan allows 50 tool calls per month.
Before you install
Write tools create and change bookings, send messages to guests through their channel (cannot be unsent), and change calendars that sync to channels; confirm before running them. Beds24 credentials are stored per user by the hosted service. Paid plans are billed through Stripe checkout links, and cancelling gives no refund for the current period.

Installation

In SourceWeft

  1. Open Beds24 MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbeds24/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "beds24-by-usefulapi": {
      "type": "http",
      "url": "https://beds24.usefulapi.io/mcp"
    }
  }
}

README

Beds24 MCP by usefulapi

Use Beds24 from Claude, Cursor, or any MCP client — check bookings, quote stays, read guest messages and reviews, and update your calendar. Hosted, no local install: connect with your own Beds24 credentials.

Live endpoint: https://beds24.usefulapi.io/mcp · Homepage: https://usefulapi.io/beds24

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://beds24.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http beds24 https://beds24.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "beds24": {      "url": "https://beds24.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Beds24 credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/beds24/

On first connect you'll provide a Beds24 invite code (or a refresh or read-only long life token) from Beds24 → Settings → Account → API. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
beds24_get_token_detailsreadGet token details
beds24_list_propertiesreadList properties
beds24_list_bookingsreadList bookings
beds24_get_bookingreadGet a booking
beds24_list_booking_messagesreadList booking messages
beds24_list_booking_invoicesreadList booking invoices
beds24_get_room_offersreadGet room offers (quote)
beds24_get_room_availabilityreadGet room availability
beds24_get_unit_bookingsreadGet unit bookings (occupancy grid)
beds24_get_room_calendarreadGet room calendar
beds24_list_fixed_pricesreadList fixed prices
beds24_list_booking_com_reviewsreadList Booking.com reviews
beds24_list_airbnb_reviewsreadList Airbnb reviews
beds24_create_bookingwriteCreate a booking
beds24_update_bookingwriteUpdate a booking
beds24_send_booking_messagewriteSend a booking message
beds24_mark_messages_readwriteMark messages read
beds24_update_room_calendarwriteUpdate room calendar
beds24_usage_statusmetaUsage status (free-tier meter)
beds24_request_featuremetaRequest a missing feature
beds24_upgrademetaUpgrade to Pro or Pro+
beds24_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run beds24_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with beds24_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with beds24_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Beds24.

Source: servers/beds24/README.md at commit 3c1b3df

Tools

18

beds24_get_token_details

Get token details

Check the configured Beds24 token: whether it is valid, its scopes, owner id, expiry, and whether it is restricted to one property. A cheap way to confirm setup and see which scopes are granted. Note Beds24 answers HTTP 200 with validToken=false for a bad token. Beds24: GET /authentication/details.

Takes no parameters.

beds24_list_properties

List properties

List the properties in the account with their address, currency, check-in times and room types (roomTypes). Optional flags include texts, pictures, offers, unit details and all rooms. Requires the properties scope. Beds24: GET /properties.

ParameterspageroomIdspropertyIdsincludeTextsincludeOffersincludeAllRoomsincludePicturesincludeLanguagesincludePriceRulesincludeUnitDetailsincludeUpsellItems

beds24_list_bookings

List bookings

Search bookings by arrival/departure date range, booking or modified time, property, room, channel, status, or a free-text search over guest name, email, booking id and API reference. With NO filters Beds24 returns only upcoming bookings. `filter` shortcuts: arrivals (arriving today), departures (departing today), new (created in the last 24h), current (in-house). Guest data needs the bookings-personal scope, invoice items bookings-financial. Beds24: GET /bookings.

ParameterspagefilterstatusarrivalchannelroomIdsarrivalTodeparturemasterIdsbookingIdsmodifiedToarrivalFrom+12 more

beds24_get_booking

Get a booking

Fetch one booking by id with its invoice items, info items and additional guests. Works for any status, including cancelled. Beds24: GET /bookings?id=<id>.

ParametersbookingIdrequired

beds24_list_booking_messages

List booking messages

Read the guest conversation on bookings — messages from guests, host replies, internal notes and system messages — across channels (Airbnb, Booking.com, Vrbo, direct). Filter by booking, property, room, read/unread, source and age. Beds24: GET /bookings/messages.

ParameterspagefiltermaxAgesourceroomIdsmasterIdsbookingIdsmessageIdspropertyIds

beds24_list_booking_invoices

List booking invoices

List invoices and their line items (charges and payments) for bookings. Requires the bookings-financial scope. Beds24 marks this endpoint Alpha. Beds24: GET /bookings/invoices.

ParameterspagebookingIds

beds24_get_room_offers

Get room offers (quote)

Quote a stay: bookable offers with total price and units available per room for given dates and guests. Use before creating a booking. Beds24: GET /inventory/rooms/offers.

ParameterspagearrivalrequiredroomIdsofferIdsagentCodedeparturerequirednumAdultsrequirednumChildrenpropertyIdsincludeTexts

beds24_get_room_availability

Get room availability

Per-date availability (true/false) for rooms over a range of nights. endDate is the LAST NIGHT (the day before check-out). Beds24: GET /inventory/rooms/availability.

ParameterspageendDateroomIdsstartDatepropertyIds

beds24_get_unit_bookings

Get unit bookings (occupancy grid)

Which units of each room type are booked on each date — an occupancy grid keyed by date. endDate is the last night. Beds24 marks this endpoint Beta. Beds24: GET /inventory/rooms/unitBookings.

ParameterspageendDateroomIdsstartDatepropertyIds

beds24_get_room_calendar

Get room calendar

Per-day calendar values for rooms: units available, min/max stay, multiplier, override (blackout, no check-in, ...) and the price slots price1..price16, as date ranges. Choose fields with the include flags; if none are set this tool asks for numAvail, minStay, maxStay, override and prices. Beds24: GET /inventory/rooms/calendar.

ParameterspageendDaterequiredroomIdsstartDaterequiredpropertyIdsincludePricesincludeMaxStayincludeMinStayincludeChannelsincludeNumAvailincludeOverrideincludeMultiplier+1 more

beds24_list_fixed_prices

List fixed prices

List fixed price rules (seasonal rates): date span, min/max nights, per-room and per-person prices, discounts, allowed arrival days and channel export. Beds24: GET /inventory/fixedPrices.

ParameterspageroomIdspropertyIdsfixedPriceIdsincludeRateCodes

beds24_list_booking_com_reviews

List Booking.com reviews

Guest reviews from Booking.com for one property, made on or after a date: scores, content, reviewer and any reply. At most 100 per call. Beds24 marks this endpoint Alpha. Beds24: GET /channels/booking/reviews.

ParametersfromrequiredpropertyIdrequired

beds24_list_airbnb_reviews

List Airbnb reviews

Guest reviews from Airbnb for one room: overall and category ratings, public review, private feedback and the host response. At most 100 per call. Beds24 marks this endpoint Beta. Beds24: GET /channels/airbnb/reviews.

ParametersroomIdrequired

beds24_create_booking

Create a booking

Create a new booking in a room for given dates and guest details. It immediately blocks inventory and is synced to connected channels. Set checkAvailability=true to refuse the booking if the room is not free, and notifyGuest / notifyHost to send confirmation emails. Undo by setting status cancelled with beds24_update_booking. Requires a token with bookings write access. Beds24: POST /bookings.

ParameterstaxcitylangemailnotesphonepricestatetitlemobileroomIdrequiredstatus+22 more

beds24_update_booking

Update a booking

Change an existing booking: dates, room/unit, guest counts, guest details, notes, flag, price, or status (e.g. confirmed, or cancelled to cancel — reversible by setting it back). Only the fields you pass change. Optionally add info items (code/text pairs). Changes sync to channels where allowed. Beds24: POST /bookings with the booking id.

ParameterstaxcitylangemailnotesphonepricestatetitlemobileroomIdstatus+21 more

beds24_send_booking_message

Send a booking message

Send a message on a booking's conversation. With source host (default) it is delivered to the GUEST through their channel (Airbnb, Booking.com, Vrbo, email) and cannot be unsent; with source internalNote it is a private host note. Beds24: POST /bookings/messages.

ParameterssourcemessagerequiredbookingIdrequired

beds24_mark_messages_read

Mark messages read

Mark one or more booking messages as read (or unread with read=false). Beds24: POST /bookings/messages with [{ id, read }].

ParametersreadmessageIdsrequired

beds24_update_room_calendar

Update room calendar

Set per-day calendar values for ONE room over a date range: units available (numAvail), minStay, maxStay, multiplier, override (none, blackout, exception, noCheckIn, noCheckOut, noCheckInOrCheckOut) and price slots price1..price16. Set a price to null to remove it. These values sync to channels. Read the current values first with beds24_get_room_calendar so you can restore them. Beds24: POST /inventory/rooms/calendar.

Parameterstorequiredfromrequiredprice1price2price3price4price5price6price7price8price9roomIdrequired+12 more

Version history

25
  1. v1.39.1LatestNov 13, 2026
  2. v1.38.0Nov 12, 2026
  3. v1.37.3Nov 11, 2026
  4. v1.36.5Nov 8, 2026
  5. v1.36.4Nov 7, 2026
  6. v1.35.3Nov 5, 2026
  7. v1.35.2Nov 5, 2026
  8. v1.35.1Nov 4, 2026
  9. v1.35.0Nov 3, 2026
  10. v1.34.1Nov 3, 2026
  11. v1.33.0Nov 1, 2026
  12. v1.31.0Oct 31, 2026
  13. v1.30.0Oct 31, 2026
  14. v1.29.2Oct 30, 2026
  15. v1.29.0Oct 30, 2026
  16. v1.24.0Oct 26, 2026
  17. v1.21.3Oct 25, 2026
  18. v1.21.0Oct 25, 2026
  19. v1.20.0Oct 24, 2026
  20. v1.17.0Oct 23, 2026
  21. v1.16.4Oct 22, 2026
  22. v1.16.3Oct 21, 2026
  23. v1.11.1Oct 9, 2026
  24. v1.10.0Oct 9, 2026
  25. v1.0.0Sep 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations