mattlong-plux avatar

Hostaway

mattlong-plux/hostaway-mcp

Connects Claude to the Hostaway property management API for short-term rental operators. Exposes read operations for reservations, listings, calendars, and guest conversations, plus write tools for updating host notes, blocking dates, and sending messages. Includes financial reporting with revenue summaries and payout reconciliation by channel. Built-in read-only mode disables mutations if you're working with shared credentials. Runs via npx with just your account ID and client secret. Useful if you manage multiple properties and want to query availability, spot booking gaps, pull guest threads, or generate reports without jumping between the Hostaway dashboard and your AI workflow.

tools
17
auth
Secret needed
transport
STDIO
env vars
4
last updated
Apr 14, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

list_reservationsList reservations with filters

List reservations with filters

No parameter schema in public metadata yet.

get_reservationGet full reservation details

Get full reservation details

No parameter schema in public metadata yet.

update_reservation_host_noteUpdate internal host note

Update internal host note

No parameter schema in public metadata yet.

list_reservations_by_propertyCurrent + upcoming reservations grouped by property

Current + upcoming reservations grouped by property

No parameter schema in public metadata yet.

list_listingsAll active listings with metadata

All active listings with metadata

No parameter schema in public metadata yet.

get_listingFull listing details

Full listing details

No parameter schema in public metadata yet.

get_listing_custom_fieldsCustom field values as name-value map

Custom field values as name-value map

No parameter schema in public metadata yet.

get_calendarAvailability and pricing calendar

Availability and pricing calendar

No parameter schema in public metadata yet.

get_gap_nightsFind short unbooked gaps between reservations

Find short unbooked gaps between reservations

No parameter schema in public metadata yet.

create_calendar_blockBlock dates on calendar

Block dates on calendar

No parameter schema in public metadata yet.

delete_calendar_blockRemove a calendar block

Remove a calendar block

No parameter schema in public metadata yet.

get_reservation_financialsFinancial breakdown for a reservation

Financial breakdown for a reservation

No parameter schema in public metadata yet.

get_revenue_summaryAggregated revenue across listings

Aggregated revenue across listings

No parameter schema in public metadata yet.

get_payout_reportPayout report for reconciliation

Payout report for reconciliation

No parameter schema in public metadata yet.

list_conversationsRecent guest conversations

Recent guest conversations

No parameter schema in public metadata yet.

get_conversationFull message thread

Full message thread

No parameter schema in public metadata yet.

send_messageSend message to guest

Send message to guest

No parameter schema in public metadata yet.

Sponsors

Configuration

HOSTAWAY_ACCOUNT_ID*

Your Hostaway account ID (integer)

HOSTAWAY_CLIENT_SECRET*secret

Your Hostaway API client secret

HOSTAWAY_READ_ONLY

Set to 'true' to disable all write/mutation tools

HOSTAWAY_CACHE_TTL

Token cache TTL in seconds when API doesn't provide expires_in (default: 240)

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

View the full README on GitHub

Details

Repository
github.com/mattlong-plux/hostaway-mcp
Category
Communication & Messaging
Package
@matt-long-plux/hostaway-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1miketwalker avatarTubePullmiketwalker/tubepull-mcpAI YouTube downloader: save YouTube, TikTok, Instagram + 10 more as MP4/MP3 from any AI chat.0stars
2mrcerq avatarAgentCanarymrcerq/agentcanary-mcpRetired compatibility stub for AgentCanary MCP. Daily briefs continue on X and Telegram.0stars
3mwbidwell avatarBionic Formsio.github.mwbidwell/bionicforms-mcpRead, search and add records in your Bionic Forms apps (hosted database apps for small teams).0stars
4myrouteonline avatarMyRouteOnlineio.github.myrouteonline/myrouteonlineMulti-stop route optimization, navigation links, and email delivery. Powered by MyRouteOnline.0stars
5oguntolaibrahim avatarImage Vieweroguntolaibrahim/inchat-image-viewer-mcpInChat Image Viewer MCP - View images inline in AI chat by just providing the file path0stars
6pipeworx-io avatarActivecampaignpipeworx-io/mcp-activecampaignActiveCampaign MCP Pack — email marketing + CRM (API v3).0stars