hostaway-mcp

Un servidor de código abierto del Model Context Protocol (MCP) que conecta asistentes de IA como Claude Desktop, Claude Code y Cursor con la API de gestión de propiedades de Hostaway. Consulta reservas, anuncios, calendarios, finanzas y conversaciones con huéspedes usando lenguaje natural.

Inicio rápido

1. Obtén tu ID de cuenta y Client Secret desde tu panel de Hostaway en Configuración > API

2. Asegúrate de tener Node.js 18+ instalado

3. Elige tu cliente de IA a continuación y añade la configuración — no necesitas clonar ni compilar

Related MCP server: Lodgify MCP Server

Configuración

Claude Desktop (Mac y Windows)

Abre tu archivo de configuración de Claude Desktop:

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

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

Añade lo siguiente (combínalo con los mcpServers existentes si tienes otros servidores configurados):

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

Reinicia Claude Desktop y ya estás listo.

Claude Code

Opción 1 — Comando CLI (el más rápido):

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

Opción 2 — .mcp.json en la raíz de tu proyecto (ideal para compartir con tu equipo):

{
  "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

Añade la misma configuración a .cursor/mcp.json de tu proyecto, o ve a Cursor Settings > MCP Servers > Add Server y pega:

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

Actualización

Si instalaste una versión anterior mediante npx, tu sistema puede tener una copia en caché. Para actualizar a la última versión:

npx clear-npx-cache

Luego reinicia tu cliente de IA (Claude Desktop, Cursor, etc.). En el próximo inicio se descargará automáticamente la última versión.

Alternativamente, puedes fijar @latest en tu configuración para obtener siempre la versión más reciente en cada reinicio:

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

Referencia de herramientas

Reservas

Anuncios

Calendario

Finanzas

Conversaciones

Modo de solo lectura

Establece HOSTAWAY_READ_ONLY=true para desactivar todas las herramientas de escritura/mutación. Cuando está activado, las siguientes herramientas devolverán un error en lugar de ejecutarse:

• update_reservation_host_note

• create_calendar_block

• delete_calendar_block

• send_message

Esto es útil para cuentas compartidas o cuando quieres evitar modificaciones accidentales.

Variables de entorno

Ejemplos de consultas

Una vez conectado, prueba a preguntarle a Claude:

• "Muéstrame todas las reservas próximas"

• "¿Cómo está la ocupación de mis propiedades el próximo mes?"

• "Encuentra noches libres en todos los anuncios para los próximos 90 días"

• "¿Cuántos ingresos obtuve el mes pasado?"

• "Muéstrame los mensajes de huéspedes no leídos"

• "¿Cuáles son las finanzas de la reserva 12345?"

• "Genera un informe de pagos para reservas de Airbnb en marzo"

Contribuciones

¡Los comentarios y las solicitudes de extracción son bienvenidos! Abre un problema en GitHub o envía un correo a matt@plux.com.

Licencia

MIT