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 分

    请在仓库或注册中心条目中声明许可证。