Hostaway

io.github.mattlong-plux由 GitHub 帳號 mattlong-plux 發布v1.0.1更新於 Oct 24, 2026

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

已驗證STDIO僅桌面效率與工作流溝通與協作商業與電商

概覽

AI 產生的概覽

將 AI 助理連接到 Hostaway 物業管理 API，用來查詢訂房、房源、行事曆、財務與房客訊息。

可以做什麼
  • 列出並檢視訂房詳情，包括依房源分組的目前與未來訂房，並可更新房東內部備註
  • 瀏覽房源中繼資料、完整詳情與自訂欄位值
  • 讀取可訂狀態與價格行事曆，找出訂房之間的短空檔，並建立或刪除行事曆封鎖
  • 取得單筆訂房的財務明細、彙總營收統計與對帳用的撥款報告
  • 列出房客對話、讀取完整訊息串並向房客發送回覆
適用情境
適合已在 Hostaway 管理短租房源，並希望用自然語言查詢訂房、住房率、營收與房客訊息的房東或物業管理者，不必在後台逐一點選。
執行需求
透過 npx 在本機執行，需要 Node.js 18 以上版本。需要 Hostaway 帳號 ID 與 API 用戶端密鑰（在 Hostaway 後台 Settings > API 取得），分別以 HOSTAWAY_ACCOUNT_ID 與 HOSTAWAY_CLIENT_SECRET 提供。可選用 HOSTAWAY_READ_ONLY 與 HOSTAWAY_CACHE_TTL。需要連線至 Hostaway API 的網路。
安裝前請注意
用戶端密鑰是 Hostaway 帳號的有效憑證，以明文環境變數寫入用戶端設定檔，請妥善保管這些檔案。多個工具會變更資料：更新房東備註、建立與刪除行事曆封鎖、向房客發送訊息。建議設定 HOSTAWAY_READ_ONLY=true 停用所有寫入工具，尤其在共用帳號上。訂房、房客與財務資料會傳送給你使用的 AI 模型供應商。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hostaway，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 9fdc0c5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。