@prosperkartik/hostaway-mcp

用于 Hostaway PMS 的模型上下文协议 (MCP) 服务器 — 将 Claude 连接到您的度假租赁运营中。

@prosperkartik/hostaway-mcp 将 Claude（在 Claude Code、Claude Desktop 或任何兼容 MCP 的客户端中）连接到您的 Hostaway 账户 — 包括房源、预订、日历可用性、房客消息和财务数据。由一位自 2022 年起为短期租赁运营商在生产环境中集成 Hostaway、Ciirus 和主要 OTA API（Airbnb、VRBO、Booking.com、Expedia、Marriott）的工程师编写。

Hostaway 是 Hostaway Inc. 的商标。本项目由社区构建，不隶属于 Hostaway，也未得到其认可。

为什么选择此服务器

三个原因：

1. 工具覆盖范围广。 10 个只读工具涵盖房源、预订、日历、对话、财务和健康检查 — 比该领域的其他社区 MCP 服务器覆盖面更广。

2. 更简洁的授权体验。 使用 Hostaway 在 API 设置页面提供的两个凭据（账户 ID + API 密钥），并在内部处理 OAuth 令牌交换。无需执行“先去别处生成承载令牌”的步骤。

3. 由深谙 API 的开发者构建。 作者拥有 3 年以上 Hostaway / Ciirus 集成生产经验，设计决策基于真实的运营商工作流程，而不仅仅是 REST 端点。

Related MCP server: Lodgify MCP Server

工具 (v0.1)

所有 v0.1 工具均为只读。写入操作将在后续版本中推出，并受显式确认保护。

快速入门

1. 获取您的 Hostaway API 凭据

在您的 Hostaway 运营商账户中 → Settings → Hostaway API。生成 API 凭据。您将获得一个 Account ID 和一个 API Key。

2. 添加到 Claude Code

claude mcp add hostaway \
  --scope user \
  -e HOSTAWAY_ACCOUNT_ID=your-account-id \
  -e HOSTAWAY_API_KEY=your-api-key \
  -- npx -y @prosperkartik/hostaway-mcp

（或使用 --scope local 仅为当前项目安装。）

3. 或添加到 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 并添加：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@prosperkartik/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_API_KEY": "your-api-key"
      }
    }
  }
}

重启 Claude Desktop。Hostaway 工具将出现在工具选择器中。

4. 尝试使用

向 Claude 询问如下问题：

• “运行 whoami 以确认 Hostaway 已连接。”

• “列出我的 Hostaway 房源。”

• “下周有哪些预订要办理入住？”

• “房源 12345 在 5 月 10 日至 17 日期间有空吗？”

• “我有未读的房客消息吗？”

• “显示我与 [房客] 的对话。”

输出示例（占位数据）

> List my Hostaway listings.

Found 3 listings:

| ID    | Name              | Location          | Beds | Baths | Capacity | Status |
|-------|-------------------|-------------------|------|-------|----------|--------|
| 10001 | Sample Apt 2BR    | Sample City, US   | 2    | 2     | 4        | active |
| 10002 | Sample Loft       | Sample City, US   | 1    | 1     | 2        | active |
| 10003 | Sample Beachfront | Sample Beach, US  | 3    | 2     | 6        | active |

> Is listing 10001 available May 10–17?

# Calendar for listing 10001
8 days returned (2026-05-10 → 2026-05-17)  ·  6 available, 2 reserved, 0 blocked

| Date       | Available | Status   | Price | Min stay | Reserved | Blocked | Note |
|------------|-----------|----------|-------|----------|----------|---------|------|
| 2026-05-10 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-11 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-12 | ✗         | reserved | 220   | 2        | 1        | 0       |      |
| ...                                                                            |

配置

服务器在启动时将这些凭据交换为承载令牌，并在进程生命周期内将其缓存在内存中。

本地开发

git clone https://github.com/prosperkartik/hostaway-mcp.git
cd hostaway-mcp
npm install
cp .env.example .env  # fill in credentials
npm run build
npm start

通过 tsx 进行热重载：

npm run dev

路线图

• [x] v0.1 — 10 个只读工具，涵盖房源、预订、日历、对话、财务和健康检查

• [ ] v0.2 — 任务 (list_tasks, get_task)；取消政策；自定义字段读取

• [ ] v0.3 — 房客付款读取；Webhook 读取

• [ ] v0.4+ — 写入操作（发送房客消息、更新日历块、创建任务），受显式 confirm: true 保护

有需求？提交 Issue 或 发起讨论。

安全性

• 凭据仅存在于环境变量中 — 本服务器从不将其写入磁盘

• 承载令牌存在于进程内存中；无持久化存储

• v0.1 是端到端的只读版本；此代码库中的任何内容都无法修改 Hostaway 数据

• 对于多房源运营商：Hostaway API 返回的数据范围仅限于您提供凭据的账户，因此无法进行跨账户访问

贡献

欢迎提交 Issue 和 PR。代码库很小且易于阅读；请从 src/index.ts 开始。

许可证

MIT — 参见 LICENSE。

作者

由 Kartik Vats (@prosperkartik) 构建 — Kodeit 的 AI 工程师。拥有三年 PMS / OTA 集成和 LLM 工具开发的生产经验。

如果您是度假租赁运营商或酒店技术团队，并希望获得将 AI 接入运营的帮助，请通过 kodeit.io 或发送电子邮件至 prosperkartik@gmail.com 与我联系。