Skip to main content
Glama

hostaway-kit

Read-only MCP server plus Cursor / Claude Code / Codex skills for operators who already run Hostaway as their PMS.

Ask an assistant about listings, calendar, inbox, and simple reports. Hostaway stays the system of record. This kit never writes — no messages, no calendar blocks, no reservations.

Shipped by STYLABS, an AI-native venture studio that builds custom Hostaway booking sites and operator dashboards. STYLABS is not an official Hostaway partner.

What you get

  1. Read-only MCP (stdio) — list_listings, get_listing, get_calendar, list_reservations, list_conversations, list_messages, plus inbox triage, draft reply, and reports.

  2. Denylist on every listing / reservation / message payload: wifiPassword, wifiUsername, doorSecurityCode, doorCode, doorCodeVendor, doorCodeInstruction, and all invoicing* contact fields.

  3. Inbox intelligence Hostaway does not compute — unanswered / SLA triage and a suggested reply grounded in that listing's fields, house rules, and calendar. Rates come from the calendar or are reported as unknown. Nothing is sent.

  4. Reports Hostaway does not ship as owner statements — occupancy and blocked holes from the calendar, unanswered thread counts, listing completeness (photos / house rules / amenities). No financials.

  5. Skills in this repo (not on npm) that tell the model to use the MCP tools and never invent numbers.

Mapped to the Hostaway Public API:

Kit behaviour

Hostaway

Active listings

GET /v1/listings?specialStatus[]=active

One listing

GET /v1/listings/{id}?includeResources=1

Calendar

GET /v1/listings/{id}/calendar?includeResources=1

Stay search on the list

availabilityDateStart, availabilityDateEnd, availabilityGuestNumber

Check-in / check-out

integers 0–23 (checkInTimeStart, checkInTimeEnd, checkOutTime)

Amenities

amenityId integers, not free-text names (GET /v1/amenities resolves names)

Inbox

GET /v1/conversations, GET /v1/conversations/{id}/messages

Create reservation / send message

out

If HOSTAWAY_ACCOUNT_ID or HOSTAWAY_CLIENT_SECRET is unset, the server serves bundled fixtures so npx still demos.

Related MCP server: Lodgify MCP Server

Install / run

npx -y hostaway-kit

Or from this repo:

npm install
npm run build
node dist/index.js

stdio only. Logs go to stderr. Credentials are optional.

Environment

Variable

Required

Purpose

HOSTAWAY_ACCOUNT_ID

for live reads

Hostaway account id (client_id on POST /v1/accessTokens)

HOSTAWAY_CLIENT_SECRET

for live reads

Client secret from the Hostaway dashboard

HOSTAWAY_KIT_NOW

no

ISO timestamp that pins "now" for SLA math (used by tests)

Get an API client secret from the Hostaway dashboard. This kit does not ship or use a Hostaway account.

Cursor

Add to ~/.cursor/mcp.json (or project .cursor/mcp.json):

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-kit"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Leave both env values empty, or omit env, to run the fixture demo.

Copy the skills from this repo into Cursor:

cp -R skills/* ~/.cursor/skills/

Claude Code

Add to ~/.claude.json (or project .mcp.json):

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-kit"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Skills:

mkdir -p .claude/skills
cp -R skills/* .claude/skills/

Codex

~/.codex/config.toml:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-kit"]

[mcp_servers.hostaway.env]
HOSTAWAY_ACCOUNT_ID = "your-account-id"
HOSTAWAY_CLIENT_SECRET = "your-client-secret"

Skills live in this repository under skills/. Point Codex at that folder or copy the SKILL.md files into your Codex skills path.

Skills (repo only)

Skill

When to use

skills/hostaway-pms

Hostaway stays the PMS. Do not push their website builder.

skills/hostaway-guest-answers

Answer guests from that listing's fields only.

skills/hostaway-availability

Date-range availability from list filters + calendar.

skills/hostaway-inbox

SLA triage and draft. Never send.

skills/hostaway-reporting

Occupancy, holes, unanswered counts, completeness.

The npm package is the MCP server only. Skills stay in git.

Tools

Tool

What it does

list_listings

Active listings; optional city / name / availability filters

get_listing

One listing, resources included, secrets stripped

get_calendar

Day rows with status, isAvailable, price (null = unknown)

list_reservations

Reservations; door codes stripped

list_conversations

Inbox threads

list_messages

Messages in a thread

inbox_triage

Unanswered + SLA (breached / waiting / answered)

draft_reply

Grounded draft. send is always false.

report_occupancy

Reserved / available / blocked + blocked holes

report_inbox

Unanswered thread counts

report_completeness

Missing photos, house rules, amenities

Occupancy rate = reserved nights ÷ (reserved + available). Blocked nights are listed as holes, not folded into occupancy.

Fixtures

Demo inventory (not a real Hostaway account):

  • 101 Harbor View Studio — complete listing. Raw fixture includes wifiPassword / invoicing contacts; the denylist strips them.

  • 102 Riverside Loft — no photos.

  • 103 Pine Cabin — no house rules, no amenities.

  • 199 — archived; omitted unless includeArchived is true.

  • August 2026 calendar on 101 with reserved nights, a two-night blocked hole (6–7 Aug), and 11 Aug with price: null.

  • Unread threads 501 (SLA breach), 502 (within SLA), 504 (pets question on the incomplete listing). 503 is answered.

Tests

npm test

Covers denylist, fixture filters, occupancy math, SLA counts, draft refusal of secrets and invented rates, and the absence of a send path.

Out of scope

Writes of any kind. Guest Payments, Stripe, WordPress plugins, a hosted Claude connector, a Cursor marketplace plugin, Hostaway's website builder, Flagship guest websites, owner statements, or live client data.

License

MIT. See LICENSE.

Hostaway is a trademark of its owner. This project is not affiliated with or endorsed by Hostaway.

Available Tools

11 tools
draft_replyA

Suggested reply grounded in THAT listing's fields, house rules, amenityId values, and calendar prices. Never invent rates (use calendar or say unknown). Never include wifi or door codes. Never POSTs a message — send is always false and there is no send endpoint.

Inputs: conversationId (required), question.

get_calendarA

Retrieve listing calendar via GET /v1/listings/{id}/calendar?includeResources=1. Each day has status (available/blocked/reserved/pending), isAvailable, and price (null means unknown — do not invent a rate). Nested reservations are denylist-stripped.

Inputs: endDate (required), listingId (required), startDate (required).

get_listingA

Retrieve one listing via GET /v1/listings/{id}?includeResources=1. House rules, check-in hours (0–23), amenityId values, and photos are included. wifiPassword, door codes, and invoicing contacts are stripped.

Inputs: listingId (required).

inbox_triageB

Unanswered / SLA view Hostaway's inbox does not compute. A thread is unanswered when the latest message is incoming (or hasUnreadMessages with no later host reply). Default SLA is 2 hours. Does not send replies.

Inputs: slaHours, listingId.

list_conversationsB

List inbox threads via GET /v1/conversations?includeResources=1. Nested Reservation objects are denylist-stripped.

Inputs: listingId, reservationId.

list_listingsA

List Hostaway listings. Defaults to GET /v1/listings?specialStatus[]=active. Optional availabilityDateStart/End + availabilityGuestNumber filter the list the same way Hostaway does. Amenities are amenityId values, not free-text names. Check-in/out hours are 0–23. Denylisted access and invoicing fields are stripped.

Inputs: city, match, includeArchived, availabilityDateEnd, +2 more.

list_messagesA

List messages in a thread via GET /v1/conversations/{id}/messages. Read-only. There is no send tool.

Inputs: conversationId (required).

list_reservationsA

List reservations via GET /v1/reservations. Read-only. doorCode / doorCodeVendor / doorCodeInstruction are stripped. Create reservation is not implemented.

Inputs: match, listingId, arrivalEndDate, arrivalStartDate.

report_completenessB

Listing completeness from reads: missing photos, missing house rules, missing amenities (empty listingAmenities). Not a financial report.

Inputs: listingId.

report_inboxB

Unanswered thread counts by listing, computed from conversation reads. Not a Hostaway owner statement.

Inputs: slaHours, listingId.

report_occupancyA

Occupancy and blocked holes computed from calendar reads. Occupancy = reserved nights / (reserved + available). Blocked holes are consecutive blocked/hardBlock days. Not an owner statement. No financials.

Inputs: endDate (required), startDate (required), listingId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource or report: reservations, conversations, messages, listings, calendar, and aggregate reports. Even the inbox-related tools operate at clearly different granularities: list_conversations lists threads, inbox_triage identifies unanswered threads, and report_inbox aggregates unanswered-thread counts by listing.

    Naming Consistency5/5

    All tool names are lowercase snake_case verb_noun: list_* for collections, get_* for single resources, report_* for computed summaries, plus inbox_triage and draft_reply. The naming pattern is consistent and predictable.

    Tool Count5/5

    11 tools is well within the ideal 3-15 range, and each tool covers a meaningful, non-redundant aspect of Hostaway read-only operations and reporting. There are no filler tools or excessive overlapping endpoints.

    Completeness3/5

    The read/triage/draft workflow is well covered, but the server is explicitly read-only: create/update/delete operations for reservations and listings are absent, and there is no send-message tool. These are notable gaps, though the descriptions openly acknowledge them and no financial/owner-statement tools are claimed.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to interact with Hostaway's property management platform through standardized MCP tools. Provides access to listings, bookings, guest communication, and availability checking for vacation rental management.
      -
    • A
      license
      B
      quality
      C
      maintenance
      A read-only hospitality-focused MCP server that enables users to retrieve reservation details, listing briefs, and guest conversation contexts from Hostaway. It simplifies hospitality workflows by providing specialized tools for searching threads and viewing reservation data through natural language interfaces.
      6
      68 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects AI assistants to the Hostaway property management API via 10 read-only tools covering listings, reservations, calendars, guest conversations, and owner statements.
      10
      625 npm
      4
      MIT