
Hostaway
Connects to the Hostaway property management system with six read-only tools built for hospitality workflows: list unread guest threads, pull conversation context, look up reservation and listing details, and search across both conversations and bookings. You pass a Hostaway API token through the environment and get Claude or Codex access to guest communication and reservation data without writing raw API calls. Intentionally narrow scope: no mutations, no message sending, no booking changes. If you're running a short-term rental operation on Hostaway and want LLM help triaging guest messages or looking up reservation details, this gives you the primitives.
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Apr 19, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
list_unread_guest_threadsRead-only, hospitality-shaped MCP server for Hostaway.
Read-only, hospitality-shaped MCP server for Hostaway.
No parameter schema in public metadata yet.
get_conversation_context
No parameter schema in public metadata yet.
get_reservation_brief
No parameter schema in public metadata yet.
get_listing_brief
No parameter schema in public metadata yet.
search_reservations
No parameter schema in public metadata yet.
search_conversations
No parameter schema in public metadata yet.
Sponsors
Configuration
HOSTAWAY_API_TOKEN*secretHostaway API token used to authenticate all requests
Readme
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
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 build
Run the stdio server locally:
HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js
Create a local npm package tarball:
npm pack
After publish, run without cloning:
npx hostaway-mcp
MCP 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:
Details
- Repository
- github.com/uncfreak1255-code/hostaway-mcp
- Package
hostaway-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active