hostaway-mcp

Ein Open-Source-Model Context Protocol (MCP)-Server, der KI-Assistenten wie Claude Desktop, Claude Code und Cursor mit der Hostaway-Immobilienverwaltungs-API verbindet. Fragen Sie Reservierungen, Inserate, Kalender, Finanzen und Gästegespräche in natürlicher Sprache ab.

Schnellstart

1. Holen Sie sich Ihre Account-ID und Ihr Client-Geheimnis aus Ihrem Hostaway-Dashboard unter Einstellungen > API

2. Stellen Sie sicher, dass Node.js 18+ installiert ist

3. Wählen Sie unten Ihren KI-Client aus und fügen Sie die Konfiguration hinzu – kein Klonen oder Erstellen erforderlich

Related MCP server: Lodgify MCP Server

Einrichtung

Claude Desktop (Mac & Windows)

Öffnen Sie Ihre Claude-Desktop-Konfigurationsdatei:

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

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

Fügen Sie Folgendes hinzu (führen Sie es mit vorhandenen mcpServers zusammen, wenn Sie andere Server konfiguriert haben):

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

Starten Sie Claude Desktop neu und schon sind Sie bereit.

Claude Code

Option 1 – CLI-Befehl (am schnellsten):

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

Option 2 – .mcp.json im Projektstamm (gut zum Teilen mit Teammitgliedern):

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

Fügen Sie dieselbe Konfiguration zur .cursor/mcp.json Ihres Projekts hinzu, oder gehen Sie zu Cursor-Einstellungen > MCP-Server > Server hinzufügen und fügen Sie Folgendes ein:

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

Aktualisieren

Wenn Sie eine frühere Version über npx installiert haben, verfügt Ihr System möglicherweise über eine zwischengespeicherte Kopie. So aktualisieren Sie auf die neueste Version:

npx clear-npx-cache

Starten Sie dann Ihren KI-Client neu (Claude Desktop, Cursor usw.). Beim nächsten Start wird automatisch die neueste Version geladen.

Alternativ können Sie @latest in Ihrer Konfiguration festlegen, um bei jedem Neustart immer die neueste Version abzurufen:

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

Werkzeugreferenz

Reservierungen

Inserate

Kalender

Finanzen

Gespräche

Nur-Lese-Modus

Setzen Sie HOSTAWAY_READ_ONLY=true, um alle Schreib-/Änderungswerkzeuge zu deaktivieren. Wenn aktiviert, geben die folgenden Werkzeuge einen Fehler zurück, anstatt ausgeführt zu werden:

• update_reservation_host_note

• create_calendar_block

• delete_calendar_block

• send_message

Dies ist nützlich für gemeinsame Konten oder wenn Sie versehentliche Änderungen verhindern möchten.

Umgebungsvariablen

Beispielabfragen

Sobald Sie verbunden sind, versuchen Sie, Claude zu fragen:

• „Zeig mir alle anstehenden Reservierungen"

• „Wie sieht die Auslastung meiner Objekte im nächsten Monat aus?"

• „Finde Lückennächte in allen Inseraten für die nächsten 90 Tage"

• „Wie viel Umsatz habe ich letzten Monat gemacht?"

• „Zeig mir ungelesene Gästenachrichten"

• „Wie sind die Finanzen für Reservierung 12345?"

• „Erstelle einen Auszahlungsbericht für Airbnb-Buchungen im März"

Mitwirken

Feedback und Pull-Requests sind willkommen! Bitte öffnen Sie ein Issue auf GitHub oder senden Sie eine E-Mail an matt@plux.com.

Lizenz

MIT