hostaway-mcp

一个开源的 Model Context Protocol (MCP) 服务器，将 Claude Desktop、Claude Code 和 Cursor 等 AI 助手连接到 Hostaway 物业管理 API。可以使用自然语言查询预订、房源、日历、财务和客人对话。

快速开始

1. 从 Hostaway 控制台的 Settings > API 获取你的 Account ID 和 Client Secret

2. 确保已安装 Node.js 18+

3. 选择下方的 AI 客户端并添加配置 — 无需克隆或构建

Related MCP server: Lodgify MCP Server

设置

Claude Desktop（Mac 和 Windows）

打开你的 Claude Desktop 配置文件：

• Mac： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%\Claude\claude_desktop_config.json

添加以下内容（如果你已配置了其他服务器，请与现有的 mcpServers 合并）：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

重启 Claude Desktop 即可使用。

Claude Code

选项 1 — CLI 命令（最快）：

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

选项 2 — 项目根目录下的 .mcp.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

将相同的配置添加到项目的 .cursor/mcp.json，或前往 Cursor Settings > MCP Servers > Add Server 并粘贴：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

更新

如果你通过 npx 安装了之前的版本，系统可能缓存了旧副本。要更新到最新版本：

npx clear-npx-cache

然后重启你的 AI 客户端（Claude Desktop、Cursor 等）。下次启动时将自动拉取最新版本。

或者，你可以在配置中固定 @latest，以便每次重启时始终获取最新版本：

"args": ["-y", "@matt-long-plux/hostaway-mcp@latest"]

工具参考

预订

房源

日历

财务

对话

只读模式

设置 HOSTAWAY_READ_ONLY=true 以禁用所有写入/变更工具。启用后，以下工具将返回错误而不是执行：

• update_reservation_host_note

• create_calendar_block

• delete_calendar_block

• send_message

这对于共享账户或希望防止意外修改的情况非常有用。

环境变量

示例查询

连接后，尝试向 Claude 提问：

• "显示所有即将到来的预订"

• "我的房源下个月的入住率怎么样？"

• "查找未来 90 天所有房源的间隔空档"

• "我上个月赚了多少收入？"

• "显示未读的客人消息"

• "预订 12345 的财务详情是什么？"

• "生成 3 月份 Airbnb 预订的付款报告"

贡献

欢迎提供反馈和拉取请求！请在 GitHub 上提交 issue，或发送邮件至 matt@plux.com。

许可证

MIT