@prosperkartik/hostaway-mcp

Сервер протокола контекста модели (MCP) для Hostaway PMS — подключите Claude к управлению вашей арендой жилья.

@prosperkartik/hostaway-mcp подключает Claude (в Claude Code, Claude Desktop или любом другом клиенте с поддержкой MCP) к вашей учетной записи Hostaway — объектам, бронированиям, доступности календаря, обмену сообщениями с гостями и финансовым данным. Создано инженером, который с 2022 года занимается интеграцией Hostaway, Ciirus и основных API OTA (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. Получите учетные данные API Hostaway

В вашей учетной записи оператора 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 с 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 — Чтение платежей гостей; Чтение вебхуков

• [ ] v0.4+ — Операции записи (отправка сообщений гостям, обновление блоков календаря, создание задач) с явным подтверждением confirm: true

Есть запрос? Откройте issue или начните обсуждение.

Безопасность

• Учетные данные хранятся только в переменных окружения — сервер никогда не