smoobu-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@smoobu-mcp get all bookings arriving in March 2025 with totals and flags"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
smoobu-mcp
Read-only MCP server over the Smoobu API, built for the monthly close and invoicing of a small portfolio of vacation rentals in Costa Rica. It replaces hand-pulled BookingList exports with six tools that return normalized, flagged, auditable rows.
Tool | Purpose |
| 14 properties with Smoobu id, EOM entity and fiscal company / bsides account |
| Arrival-based, inclusive on both ends, fully paged, with header totals, flags and an optional EOM-ready layout |
| One booking with price elements, created/modified timestamps and the raw object |
| New / modified (old → new) / cancelled since a previous extraction |
| Pro-rata by night inside the month, to reconcile with Smoobu Analytics |
| Auth and account check, never returns keys |
Status: scaffolded, not yet verified against the live API. See tasks/BOARD.md.
Run locally (stdio)
cp .env.example .env # add SMOOBU_API_KEY and SMOOBU_API_SECRET (Smoobu: Settings > Advanced > API Keys)
npm install && npm run buildClaude Code: claude mcp add smoobu -- node /path/to/smoobuMCP/dist/index.js (reads .env from the
working directory; or pass the variables with -e). Claude Desktop: add the same command to
claude_desktop_config.json.
Related MCP server: OpenLMNP
Develop
npm run check runs typecheck, lint and the unit tests (no network, no secrets). Agents: start with
CLAUDE.md. Humans: start with docs/README.md.
License
GPL-3.0, see LICENSE.
Available Tools
6 toolschanges_sinceChanges since a previous extractionA
For an arrival month: new, modified (field-level old -> new, incl. price and dates), cancelled and disappeared bookings compared with the snapshot taken at or before since by get_bookings. The start-of-month correction pass in one call.
Inputs: month (required), since (required), entity, company.
get_bookingGet one bookingB
Full detail of one booking by id: normalized row, price elements (Other Fees = 13% IVA, Host Fee = commission, Payout), created_at / modified_at and the raw Smoobu object for audit.
Inputs: id (required).
get_bookingsGet bookings by arrival dateA
Bookings arriving between arrival_from and arrival_to (both INCLUSIVE), or in month. Pages through everything. Returns a header with counts and totals per entity and per block so a short pull is obvious, then normalized rows (channel, eom_block, price_raw, lordo, commissione, netto, flags). format=eom_blocks returns rows per entity in EOM column order (Arrivo, Partenza, Nome, Netto, Commissione, Lordo; DIRETTE without commission) ready for G5/N5/U5/Z5.
Inputs: month, entity, format, company, +5 more.
list_propertiesList propertiesA
The 14 properties with Smoobu id, name, EOM entity (KALAWALA/NAMAITAMI/RIBHOLDING/DELFINES/PERLA) and fiscal company / bsides account. Casa 4 Modern = PERLA. With include_live=true also reports unmapped live apartments.
Inputs: entity, company, include_live.
smoobu_healthHealth / whoamiA
Checks each configured account: auth mode, Smoobu user, live apartment count, rate-limit status. Never returns keys.
Inputs: no named parameters.
stays_in_monthStays overlapping a month (pro-rata)A
Every booking overlapping the month with nights inside the month and pro-rated revenue, totalled per property, per portal and per entity. Reproduces Smoobu Analytics' convention so the extraction can be verified without reading the screen.
Inputs: month (required), entity, company, include_rows.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes: list_properties, get_booking (by id), changes_since, and smoobu_health are clearly separable. The main soft spot is get_bookings vs stays_in_month, which both target bookings within a month but differ by arrival-window vs overlap/pro-rated revenue convention; descriptions do enough to disambiguate but an agent could still hesitate.
All names use snake_case consistently, and list_properties/get_bookings/get_booking follow a clean verb_noun pattern. changes_since, stays_in_month, and smoobu_health deviate into noun/prepositional phrasing, which is a minor inconsistency but still readable and predictable enough.
Six tools is well-scoped for a booking extraction/audit server; each tool covers a distinct operation (enumerate properties, query bookings, fetch detail, diff changes, monthly analytics, health check). Nothing feels redundant or padded.
For a read-only extraction/reporting surface, coverage is good: properties, ranged and per-booking retrieval, change detection, monthly revenue analytics, and account health are all present with no obvious dead ends. Write/update operations are absent, but that appears intentional for this audit-oriented domain.
Related MCP Connectors
API and MCP for Airbnb, VRBO and Booking.com: messages, reservations, reviews, pricing and more.
Read-only analytics for short-term rentals: bookings, occupancy, forecasts, reviews, owner payouts.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Unofficial read-only MCP server for VeryChic hotel offers
Related MCP Servers
- AlicenseAqualityBmaintenanceA read-only MCP server for querying Timely time tracking data, providing tools for project overviews, time spent summaries, and work log entries.3MIT
- AlicenseBqualityAmaintenanceAccounting MCP server for the French LMNP tax status (furnished rentals, e.g. Airbnb hosts). 44 tools to manage properties, income and expenses, compute component-based depreciation and fiscal results, and generate the official French tax return (2031/2033) and FEC accounting export.4617AGPL 3.0
- AlicenseBqualityCmaintenanceRead-only MCP server for self-hosted Manager.io bookkeeping, providing curated GET tools to access accounting data like invoices, balances, and reports.101MIT
- FlicenseNot gradedqualityBmaintenanceMCP server for querying MyDataValue's Booking.com and Airbnb property data, including pricing, promotions, reviews, and performance metrics, via a read-only connector with automatic OAuth token rotation.-