# prosperkartik/hostaway-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/prosperkartik/hostaway-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 1371  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/prosperkartik-hostaway-mcp

## Description
MCP server for the Hostaway property management system (vacation rentals & short-term rentals). 10 read-only tools across listings, reservations, calendar availability, guest conversations, and owner financials.

## Tools
Capabilities this server exposes over MCP:

- **list_listings** — List properties (listings) on the connected Hostaway account. Returns a compact Markdown table with id, name, location, bedrooms/bathrooms, person capacity, and status.
- **get_listing** — Fetch full details for a single Hostaway listing by id. Returns location, capacity, pricing, reputation, and channel URLs as Markdown sections.
- **list_reservations** — List reservations on the connected Hostaway account. Optional filters by arrival date range and reservation status. Returns a Markdown table with the most useful operational fields.
- **get_reservation** — Fetch full details for a single Hostaway reservation by id. Returns guest info, dates, pricing breakdown, and channel details.
- **list_calendar** — Get the availability calendar for a single listing across a date range. Returns per-day availability, status, price, minimum stay, and reserved/blocked counts. Use this to answer 'is property X available between dates A and B?'
- **list_conversations** — List guest message threads (conversations) on the connected Hostaway account. Returns a compact Markdown table with conversation id, guest, linked listing/reservation, unread state, and last activity time.
- **list_unread_conversations** — List only guest message threads that have unread messages. The most useful tool for answering 'do I have any guests waiting on a reply?'
- **get_conversation_messages** — Fetch the full message history of a single conversation by id. Returns each message with direction (incoming/outgoing), timestamp, and body.
- **list_owner_statements** — List owner financial statements on the connected Hostaway account. Returns a compact table of statement id, name, and status. Useful for revenue and payout reporting.
- **whoami** — Health-check tool — confirms credentials work and returns a quick summary of the connected Hostaway account: counts of listings, reservations, conversations, owner statements, and users. Use this first when setting up to verify the connection.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "hostaway-mcp": {
    "command": "npx",
    "args": ["-y","@prosperkartik/hostaway-mcp"],
    "env": {
      "HOSTAWAY_ACCOUNT_ID": "",
      "HOSTAWAY_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `HOSTAWAY_ACCOUNT_ID`, `HOSTAWAY_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/prosperkartik-hostaway-mcp/readme_