Hostaway MCP
This is a read-only MCP server for Hostaway that enables AI agents to query hospitality data — guest conversations, reservations, and listings — without manual API calls. It does not support sending messages or modifying any data.
list_unread_guest_threads– List recent guest threads with unread status and attention signals (e.g., whether a guest needs a reply).get_conversation_context– Fetch a detailed summary of a conversation including guest info, listing details, reservation status, attention signals, and recent message history.get_reservation_brief– Get key reservation details: guest name/email, listing, channel, stay dates, booking status, and occupancy breakdown (adults, children, infants, pets).get_listing_brief– Retrieve core listing info: name, location, capacity, bedrooms, and bathrooms.search_reservations– Look up reservations by guest name, email, listing ID, reservation ID, or arrival/departure date ranges (up to 100 results).search_conversations– Find conversations by guest name, listing ID, reservation ID, or conversation ID (up to 100 results).
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 MCP show me the latest unread guest messages"
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-mcp
Read-only, hospitality-shaped MCP server for Hostaway.
This repo owns the operator product only: local/npm stdio, six read-only
tools, no Cloudflare Worker, and no Seascape booking surface.
V1 Goal
Make Codex and Claude useful in real Hostaway workflows without hand-wiring raw API calls every time.
V1 is intentionally narrow:
read-only only
hospitality-native tools, not raw endpoint parity
optimized for conversation context, reservation lookup, and listing lookup
Related MCP server: cloudbeds-mcp-server
Exact V1 Surface
list_unread_guest_threadsget_conversation_contextget_reservation_briefget_listing_briefsearch_reservationssearch_conversations
Local Development
npm install
npm test
npm run check
npm run buildRun the stdio server locally:
HOSTAWAY_API_TOKEN=your-token-here node dist/cli.jsCreate a local npm package tarball:
npm packAfter publish, run without cloning:
npx hostaway-mcpMCP Client Wiring
For local MCP clients, provide HOSTAWAY_API_TOKEN through the environment and
spawn the published npm package over stdio.
The snippets below are pinned to the current published version:
hostaway-mcp@0.2.0Update that version intentionally when you upgrade.
Claude Desktop (macOS)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json.
If you already have top-level keys like preferences, keep them and add
mcpServers alongside them:
{
"mcpServers": {
"hostaway": {
"command": "npx",
"args": ["-y", "hostaway-mcp@0.2.0"],
"env": {
"HOSTAWAY_API_TOKEN": "your-token-here"
}
}
}
}Restart Claude Desktop after saving the file.
Codex
Edit ~/.codex/config.toml and add:
[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]
[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"Verify the server is registered:
codex mcp listLocal Built CLI
If you want to run the repo checkout instead of npm, point the client at the built CLI directly:
{
"command": "node",
"args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
"env": {
"HOSTAWAY_API_TOKEN": "your-token-here"
}
}Environment Variables
Variable | Required | Default | Description |
| Yes | — | Hostaway API token used to authenticate all requests. |
| No | Hostaway production URL | Override the API base URL (useful for testing). |
V1 Non-Goals
sending guest messages
mutating reservations or listings
Cloudflare Worker transport
Seascape booking/distribution flows
webhook ingestion
background sync pipelines
dashboards or owner reporting
generic REST-to-MCP proxy coverage
Source Design
Available Tools
6 toolsget_conversation_contextC
Return an agent-friendly conversation summary plus recent message history.
Inputs: conversationId (required), detailLevel, messageLimit. Returns: raw, guest, notes, channel, +11 more
get_listing_briefC
Return the minimum useful listing context tied to conversations or reservations.
Inputs: listingId (required), detailLevel. Returns: raw, city, notes, country, +7 more
get_reservation_briefC
Return the minimum useful reservation context for an agent or operator.
Inputs: reservationId (required), detailLevel. Returns: raw, notes, status, channel, +9 more
list_unread_guest_threadsB
List recent guest threads with raw unread metadata and derived attention signals.
Inputs: limit, messageLimit. Returns: total, threads
search_conversationsC
Lookup conversations by guest name, listing, reservation id, or conversation id.
Inputs: conversationId, reservationId, guestName, listingId, +1 more. Returns: total, results
search_reservationsC
Lookup reservations by guest name, date range, listing, or reservation id.
Inputs: reservationId, guestName, guestEmail, listingId, +5 more. Returns: total, results
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are generally well-differentiated by verb (get/search/list) and resource type. While conversation, listing, and reservation domains overlap in hospitality workflows, the tools specify distinct operations (retrieval by ID vs. filtered lists vs. search) that minimize selection errors.
All tools follow a consistent snake_case verb_noun pattern with appropriate verbs (get, list, search). Minor deviation exists in noun choice: two tools use 'brief' while one uses 'context' for similar summary-retrieval purposes, slightly muddling the semantic pattern.
Six tools represent a focused, appropriate scope for guest communication and reservation lookup functionality. The count sits in the ideal range for a specialized retrieval server, avoiding bloat while covering essential read operations.
The surface provides comprehensive read access to conversations, listings, and reservations but lacks write operations such as sending messages, creating reservations, or updating listing status. This read-only limitation creates notable gaps for agents attempting to actively resolve guest issues or modify bookings.
Related MCP Connectors
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Ask your AI about your Airbnb and VRBO listings, bookings, guest messages and reviews. Read-only.
Hostfully MCP server for ChatGPT, Claude and any AI agent: list reservations, get reservation, accept booking request, send guest message, read Central Calendar and list properties in your own Hostfully account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Hostfully yourself; Cotlet does not store your password and you need no Hostfully API key. About the official Hostfully API: Hostfully has an official REST API, the Open API v3, and no official MCP server (checked 31 Oct 2026). It is a paid add-on: you email api@hostfully.com with your use case, test in a sandbox, and only then get production access. Setup and FAQ: https://cotlet.dev/integrations/hostfully-api-mcp-server
Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server for Guesty property management. Manage reservations, guests, messaging, financials, listings, and operations via AI clients.43100 npm6MIT
- AlicenseAqualityDmaintenanceMCP server that exposes Cloudbeds occupancy, check-ins/check-outs, and reservations as natural language tools, with read-only access and secure credential storage.1MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for searching stays, comparing prices across Booking.com, Airbnb, Vrbo, and Google Hotels, and fetching reviews via natural language in AI assistants.MIT
- FlicenseAqualityDmaintenanceA read-only MCP server that lets AI assistants query the WebHotelier REST API for live hotel data, including property info, room availability, rates, calendars, and offers via natural language tools.8-