Каталог MCP
prosperkartik/hostaway-mcp

prosperkartik/hostaway-mcp

Name: prosperkartik/hostaway-mcp
Availability: InStock
Author: prosperkartik

MCP-сервер для подключения Claude к Hostaway PMS. Управляйте бронированиями, календарем и сообщениями гостей прямо из ассистента. Идеален для операторов краткосрочной аренды, автоматизирующих рутин...

Github NPM Сайт сервера

README

10 инструментов

Версии

Установить сервер

@prosperkartik/hostaway-mcp

Model Context Protocol (MCP) server for the Hostaway PMS — connect Claude to your vacation rental ops.

@prosperkartik/hostaway-mcp connects Claude (in Claude Code, Claude Desktop, or any MCP-compatible client) to your Hostaway account — listings, reservations, calendar availability, guest messaging, and financials. Authored by an engineer who has integrated Hostaway, Ciirus, and major OTA APIs (Airbnb, VRBO, Booking.com, Expedia, Marriott) in production for short-term rental operators since 2022.

Hostaway is a trademark of Hostaway Inc. This project is community-built and not affiliated with or endorsed by Hostaway.

Why this server

Three reasons:

Tool coverage. 10 read-only tools across listings, reservations, calendar, conversations, financials, and a health-check — broader surface than other community MCP servers in this space.
Cleaner auth UX. Takes the two credentials Hostaway gives you on the API settings page — Account ID + API Key — and handles the OAuth token exchange internally. No "go generate a bearer token elsewhere first" step.
Built by someone who works the API. The author has 3+ years of production Hostaway / Ciirus integration work behind the design decisions. Tools map to real operator workflows, not just REST endpoints.

Инструменты были проиндексированы: 18.10.2026

get_conversation_messages

Получает полную историю сообщений одного разговора по идентификатору. Возвращает каждое сообщение с направлением (входящее/исходящее), меткой времени и телом.

Параметры

conversation_idintegerобязательный
Числовой идентификатор разговора Hostaway.

get_listing

Получает полные сведения об одном объекте Hostaway по идентификатору. Возвращает местоположение, вместимость, цены, репутацию и URL-адреса каналов в виде разделов Markdown.

Параметры

listing_idintegerобязательный
Числовой идентификатор объявления Hostaway.

get_reservation

Получает полные данные о бронировании Hostaway по ID. Возвращает информацию о госте, даты, разбивку цен и данные о канале.

Параметры

reservation_idintegerобязательный
Числовой идентификатор бронирования Hostaway.

list_calendar

Получает календарь доступности для одного объявления за диапазон дат. Возвращает подневную доступность, статус, цену, минимальное количество ночей и количество забронированных/заблокированных дней. Используйте это, чтобы ответить на вопрос «доступна ли недвижимость X между датами A и B?»

Параметры

end_datestringобязательный
Дата окончания календаря в формате YYYY-MM-DD.
listing_idintegerобязательный
Числовой идентификатор объявления Hostaway.
start_datestringобязательный
Календарная дата начала в формате YYYY-MM-DD.

list_conversations

Выводит список тем сообщений (переписок) гостей в подключенной учетной записи Hostaway. Возвращает компактную таблицу в Markdown с идентификатором переписки, гостем, связанным объявлением/бронированием, статусом прочтения и временем последнего действия.

Параметры

limitinteger
Максимальное число возвращаемых бесед (1–50, по умолчанию 20).

list_listings

Выводит список объектов (листингов) в подключённой учётной записи Hostaway. Возвращает компактную таблицу в Markdown с идентификатором, названием, местоположением, количеством спален/ванных комнат, вместимостью (количество человек) и статусом.

Параметры

limitinteger
Максимальное количество возвращаемых элементов (1-50, по умолчанию 20).

list_owner_statements

Выводит список финансовых отчётов владельца на подключённом аккаунте Hostaway. Возвращает компактную таблицу с идентификатором отчёта, названием и статусом. Полезна для отчётности по доходам и выплатам.

Параметры

limitinteger
Максимальное количество возвращаемых операторов (1-50, по умолчанию 20).

list_reservations

Выводит список бронирований из подключённого аккаунта Hostaway. Можно отфильтровать по диапазону дат заезда и статусу бронирования. Возвращает Markdown-таблицу с основными операционными полями.

Параметры

arrival_end_datestring
Фильтрует бронирования с датой заезда на эту YYYY-MM-DD или раньше.
arrival_start_datestring
Фильтрует бронирования с датой заезда не ранее YYYY-MM-DD.
limitinteger
Максимальное количество возвращаемых бронирований (1-50, по умолчанию 20).
statusstring
Фильтрует по статусу бронирования (например, 'new', 'modified', 'cancelled', 'ownerStay', 'pending', 'awaitingPayment', 'declined', 'expired', 'inquiry', 'inquiryPreapproved', 'inquiryDenied', 'inquiryTimedout', 'inquiryNotPossible').

list_unread_conversations

Выводи только те ветки сообщений гостей, в которых есть непрочитанные сообщения. Самый полезный инструмент для ответа на вопрос «ждут ли мои гости ответа?»

Параметры

limitinteger
Максимальное количество диалогов для сканирования (1-50, по умолчанию 20).

whoami

Инструмент проверки работоспособности — подтверждает, что учётные данные работают, и возвращает краткую сводку по подключённому аккаунту Hostaway: количество объявлений, бронирований, переписок, отчётов владельцев и пользователей. Используйте его в первую очередь при настройке, чтобы проверить подключение.

Параметры

Без параметров.

`0.1.1`основная	27.04.2026
`0.1.0`	26.04.2026

Выберите клиент, чтобы установить prosperkartik/hostaway-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"prosperkartik-hostaway-mcp-ecl6vqy910\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@prosperkartik/hostaway-mcp\"],\"env\":{\"HOSTAWAY_ACCOUNT_ID\":\"your-account-id\",\"HOSTAWAY_API_KEY\":\"your-api-key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add prosperkartik-hostaway-mcp-ecl6vqy910 --env HOSTAWAY_ACCOUNT_ID=your-account-id --env HOSTAWAY_API_KEY=your-api-key -- npx -y @prosperkartik/hostaway-mcp

Либо через JSON-конфиг:

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

Codex

Добавьте сервер командой в терминале:

codex mcp add prosperkartik-hostaway-mcp-ecl6vqy910 --env HOSTAWAY_ACCOUNT_ID=your-account-id --env HOSTAWAY_API_KEY=your-api-key -- npx -y @prosperkartik/hostaway-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.prosperkartik-hostaway-mcp-ecl6vqy910]
command = "npx"
args = ["-y", "@prosperkartik/hostaway-mcp"]

[mcp_servers.prosperkartik-hostaway-mcp-ecl6vqy910.env]
HOSTAWAY_ACCOUNT_ID = "your-account-id"
HOSTAWAY_API_KEY = "your-api-key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите prosperkartik/hostaway-mcp, а в поле команды запуска — строку ниже:

npx -y @prosperkartik/hostaway-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например prosperkartik-hostaway-mcp-ecl6vqy910.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: prosperkartik-hostaway-mcp-ecl6vqy910
    command: npx
    args:
      - "-y"
      - "@prosperkartik/hostaway-mcp"
    env:
      HOSTAWAY_ACCOUNT_ID: your-account-id
      HOSTAWAY_API_KEY: your-api-key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx