prosperkartik/hostaway-mcp

> Model Context Protocol (MCP) server for the Hostaway PMS — connect Claude to your vacation rental ops.
@prosperkartik/hostaway-mcp connects Claude (in Claude Code, Claude Desktop, or any MCP-compatible client) to your Hostaway account — listings, reservations, calendar availability, guest messaging, and financials. Authored by an engineer who has integrated Hostaway, Ciirus, and major OTA APIs (Airbnb, VRBO, Booking.com, Expedia, Marriott) in production for short-term rental operators since 2022.
> _Hostaway is a trademark of Hostaway Inc. This project is community-built and not affiliated with or endorsed by Hostaway._
Why this server
Three reasons:
1. **Tool coverage.** 10 read-only tools across listings, reservations, calendar, conversations, financials, and a health-check — broader surface than other community MCP servers in this space.
2. **Cleaner auth UX.** Takes the two credentials Hostaway gives you on the API settings page — Account ID + API Key — and handles the OAuth token exchange internally. No "go generate a bearer token elsewhere first" step.
3. **Built by someone who works the API.** The author has 3+ years of production Hostaway / Ciirus integration work behind the design decisions. Tools map to real operator workflows, not just REST endpoints.
Tools (v0.1)
All v0.1 tools are **read-only**. Write operations are coming in later versions, gated behind explicit confirmation.
| Tool | Description |
|---|---|
| whoami | Health-check — returns connected account counts (listings, reservations, conversations, owner statements, users). Run this first to confirm setup works. |
| list_listings | List properties on the account |
| get_listing | Full detail for a single listing — location, capacity, pricing, reputation, channel URLs |
| list_reservations | List reservations, with optional filters by arrival date range and status |
| get_reservation | Full detail for a single reservation — guest, dates, pricing, channel |
| list_calendar | Per-day availability for a listing across a date range — answers *"is property X free between A and B?"* |
| list_conversations | List guest message threads with unread state and last activity |
| list_unread_conversations | Only conversations with unread guest messages — answers *"who's waiting on a reply?"* |
| get_conversation_messages | Full message history of a single conversation |
| list_owner_statements | List owner financial statements |
Quick start
1. Get your Hostaway API credentials
In your Hostaway operator account → **Settings → Hostaway API**. Generate API credentials. You'll get an **Account ID** and an **API Key**.
2. Add to Claude Code
(Or use --scope local to install for the current project only.)
3. Or add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:
Restart Claude Desktop. The Hostaway tools appear in the tools picker.
4. Try it
Ask Claude things like:
- *"Run whoami to confirm Hostaway is connected."*
- *"List my Hostaway listings."*