Skip to main content
Glama

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

list_properties

14 properties with Smoobu id, EOM entity and fiscal company / bsides account

get_bookings

Arrival-based, inclusive on both ends, fully paged, with header totals, flags and an optional EOM-ready layout

get_booking

One booking with price elements, created/modified timestamps and the raw object

changes_since

New / modified (old → new) / cancelled since a previous extraction

stays_in_month

Pro-rata by night inside the month, to reconcile with Smoobu Analytics

smoobu_health

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 build

Claude 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 tools
changes_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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      Accounting 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.
      46
      17
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Read-only MCP server for self-hosted Manager.io bookkeeping, providing curated GET tools to access accounting data like invoices, balances, and reports.
      10
      1
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP 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.
      -