Log inSubmit server
Hostaway MCP logo

Hostaway MCP

by prosperkartik

Read-only Hostaway tools for listings, reservations, availability, guest conversations, owner statements, and account checks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hostaway MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "prosperkartik-hostaway-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@prosperkartik/hostaway-mcp"
      ],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_VALUE_HERE",
        "HOSTAWAY_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 10 tools correctly (1mo ago).

Overview

The prosperkartik/hostaway-mcp MCP server connects MCP clients to Hostaway property management accounts through the Hostaway API. It provides 10 read-only tools for listings, reservations, calendar availability, guest conversations, owner statements, and connection checks. Configure it with a Hostaway Account ID and API Key; the server exchanges them for a bearer token and keeps that token in process memory. Reach for it when an agent needs to inspect vacation rental operations without changing Hostaway data.

Use cases

  • Check upcoming reservations by arrival range or status
  • Verify listing availability for a date range
  • Review unread guest conversations
  • Inspect listing and reservation details
  • List owner financial statements

Key features

  • Read Hostaway listings and property details
  • Filter and inspect reservations
  • Query per-day calendar availability
  • List unread and full guest conversations
  • List owner financial statements
  • Check account connectivity with whoami

Tools10

What Hostaway MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

18/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @prosperkartik/hostaway-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads66Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed10Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Hostaway MCP works

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.

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hostaway MCP

Run it with npx using `npx -y @prosperkartik/hostaway-mcp`, and provide `HOSTAWAY_ACCOUNT_ID` and `HOSTAWAY_API_KEY`.

Yes. The README provides a Claude Desktop configuration using npx and the two required Hostaway environment variables.

It requires a Hostaway Account ID and API Key, supplied through `HOSTAWAY_ACCOUNT_ID` and `HOSTAWAY_API_KEY`.

No. The documented v0.1 tools are read-only and do not mutate Hostaway data.

Call the `whoami` tool. It confirms the credentials and returns counts for connected account resources.

Related MCP servers

All in Travel & Transportation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHostaway MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/prosperkartik-hostaway-mcp?style=directory)](https://allmcps.com/mcp/prosperkartik-hostaway-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/prosperkartik-hostaway-mcp"><img src="https://allmcps.com/api/badge/prosperkartik-hostaway-mcp?style=directory" alt="Hostaway MCP on AllMCPs" /></a>