hostaway-kit
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., "@hostaway-kit Show me occupancy for the next 30 days."
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.
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
Read-only MCP (stdio) —
list_listings,get_listing,get_calendar,list_reservations,list_conversations,list_messages, plus inbox triage, draft reply, and reports.Denylist on every listing / reservation / message payload:
wifiPassword,wifiUsername,doorSecurityCode,doorCode,doorCodeVendor,doorCodeInstruction, and allinvoicing*contact fields.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.
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.
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 |
|
One listing |
|
Calendar |
|
Stay search on the list |
|
Check-in / check-out | integers 0–23 ( |
Amenities |
|
Inbox |
|
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-kitOr from this repo:
npm install
npm run build
node dist/index.jsstdio only. Logs go to stderr. Credentials are optional.
Environment
Variable | Required | Purpose |
| for live reads | Hostaway account id ( |
| for live reads | Client secret from the Hostaway dashboard |
| 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 |
| Hostaway stays the PMS. Do not push their website builder. |
| Answer guests from that listing's fields only. |
| Date-range availability from list filters + calendar. |
| SLA triage and draft. Never send. |
| Occupancy, holes, unanswered counts, completeness. |
The npm package is the MCP server only. Skills stay in git.
Tools
Tool | What it does |
| Active listings; optional city / name / availability filters |
| One listing, resources included, secrets stripped |
| Day rows with status, |
| Reservations; door codes stripped |
| Inbox threads |
| Messages in a thread |
| Unanswered + SLA ( |
| Grounded draft. |
| Reserved / available / blocked + blocked holes |
| Unanswered thread counts |
| 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
includeArchivedis 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 testCovers 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 toolsdraft_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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Ask your AI about your Airbnb and VRBO listings, bookings, guest messages and reviews. Read-only.
Read-only analytics for short-term rentals: bookings, occupancy, forecasts, reviews, owner payouts.
Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.
Read-only AI access to HAVN properties, leads, tasks, files, media, and analytics.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- AlicenseAqualityDmaintenanceEnables interaction with the Lodgify vacation rental API to manage properties, bookings, and calendar data. It provides tools for retrieving property details, creating or updating bookings, and monitoring rental availability.821 PyPI2MIT
- AlicenseBqualityCmaintenanceA 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.668 npmMIT
- AlicenseAqualityDmaintenanceConnects AI assistants to the Hostaway property management API via 10 read-only tools covering listings, reservations, calendars, guest conversations, and owner statements.10625 npm4MIT