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

Prerequisites

• Node.js 18+
• A Hostaway account with API credentials
• Your Account ID and Client Secret — find these in your Hostaway dashboard under Settings > API

Installation

Claude Desktop

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "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

Add the server to your project's .mcp.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"
      }
    }
  }
}

Tools Reference

Reservations

Tool	Description	Key Parameters
list_reservations	List reservations with filters	listingMapId, dateFrom, dateTo, status, channelId, limit
get_reservation	Get full reservation details	reservationId (required)
update_reservation_host_note	Update internal host note	reservationId, hostNote (required)
list_reservations_by_property	Current + upcoming reservations grouped by property	None

Listings

Tool	Description	Key Parameters
list_listings	All active listings with metadata	includeArchived
get_listing	Full listing details	listingId (required)
get_listing_custom_fields	Custom field values as name-value map	listingId (required)

Calendar

Tool	Description	Key Parameters
get_calendar	Availability and pricing calendar	listingId, startDate, endDate (all required)
get_gap_nights	Find short unbooked gaps between reservations	listingId (required), startDate, endDate, maxGapLength
create_calendar_block	Block dates on calendar	listingId, startDate, endDate (required), note
delete_calendar_block	Remove a calendar block	listingId, calendarBlockId (required)

Financials

Tool	Description	Key Parameters
get_reservation_financials	Financial breakdown for a reservation	reservationId (required)
get_revenue_summary	Aggregated revenue across listings	dateFrom, dateTo (required), listingId
get_payout_report	Payout report for reconciliation	dateFrom, dateTo (required), channelId

Conversations

Tool	Description	Key Parameters
list_conversations	Recent guest conversations	listingId, limit, unreadOnly
get_conversation	Full message thread	conversationId (required)
send_message	Send message to guest	conversationId, message (required)

Read-Only Mode

Set HOSTAWAY_READ_ONLY=true to disable all write/mutation

... View full README on GitHub