@prosperkartik/hostaway-mcp

Model Context Protocol (MCP)-Server für das Hostaway PMS — verbinden Sie Claude mit Ihrem Ferienvermietungsbetrieb.

@prosperkartik/hostaway-mcp verbindet Claude (in Claude Code, Claude Desktop oder einem beliebigen MCP-kompatiblen Client) mit Ihrem Hostaway-Konto — Inserate, Reservierungen, Kalenderverfügbarkeit, Gästenachrichten und Finanzen. Erstellt von einem Ingenieur, der seit 2022 Hostaway, Ciirus und große OTA-APIs (Airbnb, VRBO, Booking.com, Expedia, Marriott) in der Produktion für Betreiber von Kurzzeitvermietungen integriert hat.

Hostaway ist eine Marke von Hostaway Inc. Dieses Projekt wurde von der Community erstellt und ist nicht mit Hostaway verbunden oder von Hostaway unterstützt.

Warum dieser Server

Drei Gründe:

1. Tool-Abdeckung. 10 schreibgeschützte Tools für Inserate, Reservierungen, Kalender, Konversationen, Finanzen und einen Gesundheitscheck — eine breitere Oberfläche als andere Community-MCP-Server in diesem Bereich.

2. Sauberere Auth-UX. Nimmt die zwei Anmeldedaten, die Hostaway Ihnen auf der API-Einstellungsseite gibt — Account ID + API Key — und wickelt den OAuth-Token-Austausch intern ab. Kein Schritt wie "Gehen Sie woanders hin, um ein Bearer-Token zu generieren".

3. Erstellt von jemandem, der mit der API arbeitet. Der Autor hat über 3 Jahre Erfahrung in der Produktion mit Hostaway-/Ciirus-Integrationen, die in die Designentscheidungen eingeflossen sind. Die Tools bilden echte Arbeitsabläufe von Betreibern ab, nicht nur REST-Endpunkte.

Related MCP server: Lodgify MCP Server

Tools (v0.1)

Alle v0.1-Tools sind schreibgeschützt. Schreibvorgänge folgen in späteren Versionen und sind durch eine explizite Bestätigung geschützt.

Schnellstart

1. Holen Sie sich Ihre Hostaway-API-Anmeldedaten

In Ihrem Hostaway-Betreiberkonto → Settings → Hostaway API. Generieren Sie API-Anmeldedaten. Sie erhalten eine Account ID und einen API Key.

2. Zu Claude Code hinzufügen

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

(Oder verwenden Sie --scope local, um es nur für das aktuelle Projekt zu installieren.)

3. Oder zu Claude Desktop hinzufügen

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) und fügen Sie Folgendes hinzu:

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

Starten Sie Claude Desktop neu. Die Hostaway-Tools erscheinen in der Tool-Auswahl.

4. Ausprobieren

Fragen Sie Claude Dinge wie:

• "Führe whoami aus, um zu bestätigen, dass Hostaway verbunden ist."

• "Liste meine Hostaway-Inserate auf."

• "Welche Reservierungen checken nächste Woche ein?"

• "Ist Inserat 12345 vom 10. bis 17. Mai verfügbar?"

• "Habe ich ungelesene Gästenachrichten?"

• "Zeige mir die Konversation mit [Gast]."

Beispielausgabe (Platzhalterdaten)

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

Konfiguration

Der Server tauscht diese beim Start gegen ein Bearer-Token aus und speichert es für die Dauer des Prozesses im Arbeitsspeicher.

Lokale Entwicklung

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

Hot-Reload via tsx:

npm run dev

Roadmap

• [x] v0.1 — 10 schreibgeschützte Tools für Inserate, Reservierungen, Kalender, Konversationen, Finanzen und Gesundheitscheck

• [ ] v0.2 — Aufgaben (list_tasks, get_task); Stornierungsbedingungen; Lesen benutzerdefinierter Felder

• [ ] v0.3 — Lesen von Gastzahlungen; Lesen von Webhooks

• [ ] v0.4+ — Schreibvorgänge (Gästenachrichten senden, Kalenderblöcke aktualisieren, Aufgaben erstellen), geschützt durch explizites confirm: true

Haben Sie einen Wunsch? Öffnen Sie ein Issue oder starten Sie eine Diskussion.

Sicherheit

• Anmeldedaten befinden sich nur in Umgebungsvariablen — sie werden von diesem Server niemals auf die Festplatte geschrieben

• Das Bearer-Token befindet sich im Prozessspeicher; kein persistenter Speicher

• v0.1 ist durchgehend schreibgeschützt; nichts in dieser Codebasis kann Hostaway-Daten verändern

• Für Betreiber mit mehreren Immobilien: Die Hostaway-API gibt Daten zurück, die auf das Konto beschränkt sind, dessen Anmeldedaten Sie bereitstellen, daher ist ein kontoübergreifender Zugriff nicht möglich

Mitwirken

Issues und PRs sind willkommen. Die Codebasis ist klein und leicht zu lesen; beginnen Sie bei src/index.ts.

Lizenz

MIT — siehe LICENSE.

Autor

Erstellt von Kartik Vats (@prosperkartik) — KI-Ingenieur bei Kodeit. Drei Jahre Produktionserfahrung mit PMS-/OTA-Integrationen und LLM-Tooling.

Wenn Sie ein Betreiber von Ferienvermietungen oder ein Hospitality-Tech-Team sind und Hilfe bei der Einbindung von KI in Ihre Betriebsabläufe benötigen, kontaktieren Sie uns über kodeit.io oder per E-Mail an prosperkartik@gmail.com.