hostaway-mcp 是一个开源的 Model Context Protocol（MCP）服务器，旨在将 Claude 连接到 Hostaway 度假租赁管理系统（PMS），从而让用户通过 AI 助手直接访问和管理度假租赁运营数据。该项目由 @prosperkartik 开发，作者自 2022 年以来一直从事短租运营商的 Hostaway、Ciirus 以及主要 OTA API（Airbnb、VRBO、Booking.com、Expedia、Marriott）的生产集成工作。Hostaway 是 Hostaway Inc. 的商标，本项目为社区构建，与 Hostaway 无关联或背书。
用途 该服务器的主要用途是让 Claude（在 Claude Code、Claude Desktop 或任何兼容 MCP 的客户端中）能够安全地查询 Hostaway 账户中的关键业务数据，包括房源列表、预订信息、日历可用性、房客消息和财务数据。它面向度假租赁运营商和酒店技术团队，帮助将 AI 集成到日常运营中。
主要能力 v0.1 版本提供 10 个只读工具，覆盖以下领域：
- 房源（listings）：列出 Hostaway 账户中的房源。
- 预订（reservations）：查询预订信息，例如下周入住的预订。
- 日历（calendar）：检查特定房源在指定日期范围内的可用性。
- 对话（conversations）：查看未读房客消息，或展示与特定房客的对话。
- 财务（financials）：访问业主财务数据。
- 健康检查（health-check）：通过 whoami 等工具确认 Hostaway 连接状态。
该服务器在启动时使用 Hostaway API 设置页面提供的 Account ID 和 API Key 进行 OAuth 令牌交换，并将 bearer token 缓存在内存中，无需用户手动生成令牌。所有 v0.1 工具均为只读，无法修改 Hostaway 数据。
使用方式
- 获取 Hostaway API 凭据：在 Hostaway 运营商账户中，进入 Settings → Hostaway API，生成 API 凭据，获得 Account ID 和 API Key。
- 添加到 Claude Code：使用相应的安装命令（或使用 --scope local 仅安装到当前项目）。
- 添加到 Claude Desktop：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS），添加配置后重启 Claude Desktop，Hostaway 工具将出现在工具选择器中。 配置完成后，可以向 Claude 提出如下问题：
- “运行 whoami 确认 Hostaway 已连接。”
- “列出我的 Hostaway 房源。”
- “下周有哪些预订要入住？”
- “房源 12345 在 5 月 10 日至 17 日是否可用？”
- “我有未读的房客消息吗？”
- “显示与 [房客] 的对话。”
适用场景 该工具适用于度假租赁运营商、酒店技术团队以及需要将 AI 集成到物业管理运营中的开发者。它可以帮助快速查询房源状态、预订情况、日历可用性和房客沟通记录，提升运营效率。
限制
- v0.1 版本所有工具均为只读，不支持写入操作。
- 写入操作计划在后续版本中推出，并需要显式确认（confirm: true）。
- 凭据仅存储在环境变量中，服务器不会将其写入磁盘；bearer token 仅存在于进程内存中，无持久化存储。
- 对于多物业运营商，Hostaway API 返回的数据范围限于所提供凭据对应的账户，无法跨账户访问。
- 后续版本路线图：v0.2 计划添加任务（list_tasks、get_task）、取消政策、自定义字段读取；v0.3 计划添加房客支付读取、Webhooks 读取；v0.4+ 计划添加写入操作（发送房客消息、更新日历块、创建任务），需显式确认。
该项目采用 MIT 许可证，代码库小巧易读，欢迎提交问题和 PR。
