@prosperkartik/hostaway-mcp

Servidor del Protocolo de Contexto de Modelo (MCP) para el PMS de Hostaway: conecta a Claude con tus operaciones de alquiler vacacional.

@prosperkartik/hostaway-mcp conecta a Claude (en Claude Code, Claude Desktop o cualquier cliente compatible con MCP) con tu cuenta de Hostaway: listados, reservas, disponibilidad de calendario, mensajería con huéspedes y finanzas. Creado por un ingeniero que ha integrado Hostaway, Ciirus y las principales APIs de OTA (Airbnb, VRBO, Booking.com, Expedia, Marriott) en producción para operadores de alquiler a corto plazo desde 2022.

Hostaway es una marca comercial de Hostaway Inc. Este proyecto ha sido creado por la comunidad y no está afiliado ni respaldado por Hostaway.

Por qué este servidor

Tres razones:

1. Cobertura de herramientas. 10 herramientas de solo lectura que abarcan listados, reservas, calendario, conversaciones, finanzas y una verificación de estado; una superficie más amplia que otros servidores MCP de la comunidad en este ámbito.

2. UX de autenticación más limpia. Toma las dos credenciales que Hostaway te proporciona en la página de configuración de la API (ID de cuenta + Clave de API) y gestiona el intercambio de tokens OAuth internamente. Sin pasos de "ve a generar un token de portador a otro lugar primero".

3. Creado por alguien que trabaja con la API. El autor tiene más de 3 años de experiencia en trabajo de integración de Hostaway / Ciirus en producción detrás de las decisiones de diseño. Las herramientas se asignan a flujos de trabajo reales de operadores, no solo a endpoints REST.

Related MCP server: Lodgify MCP Server

Herramientas (v0.1)

Todas las herramientas de la v0.1 son de solo lectura. Las operaciones de escritura llegarán en versiones posteriores, protegidas tras una confirmación explícita.

Inicio rápido

1. Obtén tus credenciales de la API de Hostaway

En tu cuenta de operador de Hostaway → Settings → Hostaway API. Genera las credenciales de la API. Obtendrás un Account ID y una API Key.

2. Añadir a 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

(O usa --scope local para instalar solo para el proyecto actual.)

3. O añadir a Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) y añade:

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

Reinicia Claude Desktop. Las herramientas de Hostaway aparecerán en el selector de herramientas.

4. Pruébalo

Pregúntale a Claude cosas como:

• "Ejecuta whoami para confirmar que Hostaway está conectado."

• "Lista mis propiedades de Hostaway."

• "¿Qué reservas tienen entrada la próxima semana?"

• "¿Está disponible el listado 12345 del 10 al 17 de mayo?"

• "¿Tengo algún mensaje de huésped sin leer?"

• "Muéstrame la conversación con [huésped]."

Ejemplo de salida (datos de marcador de posición)

> 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       |      |
| ...                                                                            |

Configuración

El servidor intercambia esos datos por un token de portador al inicio y lo almacena en caché en la memoria durante la vida útil del proceso.

Desarrollo local

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

Recarga en caliente mediante tsx:

npm run dev

Hoja de ruta

• [x] v0.1 — 10 herramientas de solo lectura que abarcan listados, reservas, calendario, conversaciones, finanzas y verificación de estado

• [ ] v0.2 — Tareas (list_tasks, get_task); Políticas de cancelación; Lectura de campos personalizados

• [ ] v0.3 — Lectura de pagos de huéspedes; Lectura de webhooks

• [ ] v0.4+ — Operaciones de escritura (enviar mensajes a huéspedes, actualizar bloques de calendario, crear tareas) protegidas tras una confirmación explícita confirm: true

¿Tienes alguna petición? Abre un issue o inicia una discusión.

Seguridad

• Las credenciales viven solo en variables de entorno; nunca son escritas en el disco por este servidor

• El token de portador vive en la memoria del proceso; no hay almacenamiento persistente

• La v0.1 es de solo lectura de principio a fin; nada en este código base puede mutar los datos de Hostaway

• Para operadores con múltiples propiedades: la API de Hostaway devuelve datos limitados a la cuenta cuyas credenciales suministras, por lo que el acceso entre cuentas no es posible

Contribución

Los issues y PRs son bienvenidos. El código base es pequeño y fácil de leer; empieza en src/index.ts.

Licencia

MIT — ver LICENSE.

Autor

Creado por Kartik Vats (@prosperkartik) — Ingeniero de IA en Kodeit. Tres años de trabajo en producción en integraciones de PMS / OTA y herramientas de LLM.

Si eres un operador de alquiler vacacional o un equipo de tecnología hotelera y quieres ayuda para integrar IA en tus operaciones, ponte en contacto a través de kodeit.io o envía un correo a prosperkartik@gmail.com.