hostaway-mcp

Открытый сервер Model Context Protocol (MCP), который подключает ИИ-ассистентов, таких как Claude Desktop, Claude Code и Cursor, к API управления недвижимостью Hostaway. Запрашивайте бронирования, объекты, календари, финансовые данные и переписки с гостями на естественном языке.

Быстрый старт

1. Получите Идентификатор аккаунта и Секрет клиента в панели Hostaway в разделе Settings > API

2. Убедитесь, что у вас установлен Node.js 18+

3. Выберите свой ИИ-клиент ниже и добавьте конфигурацию — клонирование и сборка не требуются

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

Затем перезапустите ваш ИИ-клиент (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?»

• «Сформируй отчёт о выплатах для бронирований Airbnb за март»

Вклад в проект

Отзывы и pull request'ы приветствуются! Пожалуйста, создайте issue на GitHub или напишите на matt@plux.com.

Лицензия

MIT