Hostaway MCP

What prosperkartik/hostaway-mcp MCP server does

The prosperkartik/hostaway-mcp MCP server gives an MCP-compatible client a read-only view of a Hostaway account. It is intended for vacation rental and short-term rental operations where an agent needs to inspect property data, booking activity, availability, guest messages, or owner financial statements.

The server covers ten tools:

• whoami checks the connection and reports counts for listings, reservations, conversations, owner statements, and users.
• list_listings and get_listing expose compact or detailed property information, including location, capacity, pricing, reputation, status, and channel URLs.
• list_reservations and get_reservation provide reservation lists and individual booking details. Listing results can be filtered by arrival date range and reservation status.
• list_calendar returns daily availability, status, price, minimum stay, and reserved or blocked counts for one listing and a date range.
• list_conversations, list_unread_conversations, and get_conversation_messages support guest message monitoring and history review.
• list_owner_statements lists owner financial statements with their identifiers, names, and statuses.

Results are formatted for agent use, with several tools returning Markdown tables or sections.

How it works

At startup, the server reads the Hostaway account credentials from environment variables and exchanges them for a Hostaway bearer token. The token is cached only in the running process. API data is scoped to the Hostaway account associated with the supplied credentials, so the server does not provide cross-account access.

All tools in the documented v0.1 release are read-only. They can retrieve operational information but cannot send guest messages, alter calendar blocks, create tasks, or otherwise mutate Hostaway records. The whoami tool is the recommended first request because it confirms that authentication works and gives a quick view of the connected account.

Setup and configuration

Obtain an Account ID and API Key from the Hostaway operator account under Settings and Hostaway API. Then provide them as environment variables when launching the server:

• HOSTAWAY_ACCOUNT_ID — the Hostaway account identifier.
• HOSTAWAY_API_KEY — the Hostaway API secret.

For Claude Desktop, configure npx with the package @prosperkartik/hostaway-mcp and pass both variables in the MCP server's env object. The documented command is also suitable for Claude Code using its MCP add command. The prosperkartik/hostaway-mcp MCP server can alternatively be developed locally by cloning the repository, installing npm dependencies, building the project, and running its start script.

Credentials are supplied through environment variables and are not written to disk by the server. The bearer token remains in memory for the lifetime of the process.

Tools and capabilities

Use the listing tools to inspect a portfolio and retrieve property-level details. Use reservation filters to investigate arrivals within a date range or bookings with a particular status. Calendar data supports questions about whether a particular listing is available between two dates, along with nightly price and minimum-stay information.

For guest operations, unread conversation filtering helps identify threads that may need attention, while the message-history tool returns message direction, timestamp, and body. Owner statement listing supports basic financial and payout reporting, but the supplied tool list does not include detailed statement retrieval.

Limitations and notes

The prosperkart/hostaway-mcp MCP server currently exposes only the ten read-only v0.1 tools. Planned functionality such as tasks, cancellation policies, custom fields, guest payments, webhooks, and write operations is not part of the documented current release.

A Hostaway account and its API credentials are required. The material does not describe a no-credential or mock mode. The project is community-built and is not affiliated with or endorsed by Hostaway. It is licensed under MIT.