Hostaway

io.github.mattlong-pluxPublished by GitHub account mattlong-pluxv1.0.1Updated Oct 24, 2026

Hostaway PMS: reservations, listings, calendars, financials, and guest messaging.

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Connects an AI assistant to the Hostaway property management API to query reservations, listings, calendars, financials and guest messages.

What you can do
  • List and inspect reservations, including upcoming bookings grouped by property, and update internal host notes
  • Browse listings with metadata, full details and custom field values
  • Read availability and pricing calendars, find short unbooked gap nights, and create or delete calendar blocks
  • Pull reservation financial breakdowns, aggregated revenue summaries and payout reports for reconciliation
  • List guest conversations, read full message threads and send replies to guests
When to use it
Useful for short-term rental hosts and property managers who already run their portfolio on Hostaway and want to ask questions about bookings, occupancy, revenue and guest messages in natural language instead of clicking through the dashboard.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed. Requires a Hostaway account ID and API client secret from the Hostaway dashboard (Settings > API), supplied as HOSTAWAY_ACCOUNT_ID and HOSTAWAY_CLIENT_SECRET. Optional HOSTAWAY_READ_ONLY and HOSTAWAY_CACHE_TTL settings. Network access to the Hostaway API.
Before you install
The client secret is a live credential for your Hostaway account; it is passed in plain environment variables in client config files, so keep those files private. Several tools change data: updating host notes, creating and deleting calendar blocks, and sending messages to guests. Set HOSTAWAY_READ_ONLY=true to disable all write tools, especially on shared accounts. Reservation, guest and financial data is sent to the AI model provider you use.

Installation

In SourceWeft

  1. Open Hostaway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

hostaway-mcp

[npm version] [License: MIT] [MCP]

An open-source Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop, Claude Code, and Cursor to the Hostaway property management API. Query reservations, listings, calendars, financials, and guest conversations using natural language.

Quick Start

  1. Get your Account ID and Client Secret from your Hostaway dashboard under Settings > API
  2. Make sure you have Node.js 18+ installed
  3. Pick your AI client below and add the config — no cloning or building required

Setup

Claude Desktop (Mac & Windows)

Open your Claude Desktop config file:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following (merge with existing mcpServers if you have other servers configured):

json
{  "mcpServers": {    "hostaway": {      "command": "npx",      "args": ["-y", "@matt-long-plux/hostaway-mcp"],      "env": {        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"      }    }  }}

Restart Claude Desktop and you're ready to go.

Claude Code

Option 1 — CLI command (quickest):

bash
claude mcp add hostaway \  -e HOSTAWAY_ACCOUNT_ID=YOUR_ACCOUNT_ID \  -e HOSTAWAY_CLIENT_SECRET=YOUR_CLIENT_SECRET \  -- npx -y @matt-long-plux/hostaway-mcp

Option 2 — .mcp.json in your project root (good for sharing with teammates):

json
{  "mcpServers": {    "hostaway": {      "command": "npx",      "args": ["-y", "@matt-long-plux/hostaway-mcp"],      "env": {        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"      }    }  }}

Cursor

Add the same config to your project's .cursor/mcp.json, or go to Cursor Settings > MCP Servers > Add Server and paste:

json
{  "mcpServers": {    "hostaway": {      "command": "npx",      "args": ["-y", "@matt-long-plux/hostaway-mcp"],      "env": {        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"      }    }  }}

Updating

If you installed a previous version via npx, your system may have a cached copy. To update to the latest release:

bash
npx clear-npx-cache

Then restart your AI client (Claude Desktop, Cursor, etc.). The next launch will automatically pull the latest version.

Alternatively, you can pin @latest in your config to always fetch the newest version on each restart:

json
"args": ["-y", "@matt-long-plux/hostaway-mcp@latest"]

Tools Reference

Reservations

ToolDescriptionKey Parameters
list_reservationsList reservations with filterslistingMapId, dateFrom, dateTo, status, channelId, limit
get_reservationGet full reservation detailsreservationId (required)
update_reservation_host_noteUpdate internal host notereservationId, hostNote (required)
list_reservations_by_propertyCurrent + upcoming reservations grouped by propertyNone

Listings

ToolDescriptionKey Parameters
list_listingsAll active listings with metadataincludeArchived
get_listingFull listing detailslistingId (required)
get_listing_custom_fieldsCustom field values as name-value maplistingId (required)

Calendar

ToolDescriptionKey Parameters
get_calendarAvailability and pricing calendarlistingId, startDate, endDate (all required)
get_gap_nightsFind short unbooked gaps between reservationslistingId (required), startDate, endDate, maxGapLength
create_calendar_blockBlock dates on calendarlistingId, startDate, endDate (required), note
delete_calendar_blockRemove a calendar blocklistingId, calendarBlockId (required)

Financials

ToolDescriptionKey Parameters
get_reservation_financialsFinancial breakdown for a reservationreservationId (required)
get_revenue_summaryAggregated revenue across listingsdateFrom, dateTo (required), listingId
get_payout_reportPayout report for reconciliationdateFrom, dateTo (required), channelId

Conversations

ToolDescriptionKey Parameters
list_conversationsRecent guest conversationslistingId, limit, unreadOnly
get_conversationFull message threadconversationId (required)
send_messageSend message to guestconversationId, message (required)

Read-Only Mode

Set HOSTAWAY_READ_ONLY=true to disable all write/mutation tools. When enabled, the following tools will return an error instead of executing:

  • update_reservation_host_note
  • create_calendar_block
  • delete_calendar_block
  • send_message

This is useful for shared accounts or when you want to prevent accidental modifications.

Environment Variables

VariableRequiredDescription
HOSTAWAY_ACCOUNT_IDYesYour Hostaway account ID (integer)
HOSTAWAY_CLIENT_SECRETYesYour Hostaway API client secret
HOSTAWAY_READ_ONLYNoSet to true to disable write operations
HOSTAWAY_CACHE_TTLNoToken cache TTL in seconds (default: 240)

Example Queries

Once connected, try asking Claude:

  • "Show me all upcoming reservations"
  • "What's the occupancy looking like for my properties next month?"
  • "Find gap nights across all listings for the next 90 days"
  • "How much revenue did I make last month?"
  • "Show me unread guest messages"
  • "What are the financials for reservation 12345?"
  • "Generate a payout report for Airbnb bookings in March"

Contributing

Feedback and pull requests are welcome! Please open an issue on GitHub or email [email protected].

License

MIT

Source: README.md at commit 9fdc0c5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.