# hostaway-kit

> hostaway-kit is a free MCP server for maps and travel. Read-only Hostaway access for listings, calendars, inbox triage and simple reports. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://www.stylabs.com/work/hostaway
- **Repository:** https://github.com/stylabs/hostaway-kit-mcp-skills
- **MCP Registry name:** io.github.stylabs/hostaway-kit
- **Categories:** maps and travel, productivity
- **Listing updated:** 2026-11-15

## About

Operators who already run Hostaway as their property management system can ask an assistant about listings, availability and guest messages while the PMS stays the system of record. The kit never writes: no messages, no calendar blocks, no reservations.

Sensitive fields are stripped before anything reaches the model, including Wi-Fi credentials and door codes and all invoicing contact fields. The extras go beyond what Hostaway computes: unanswered-thread and SLA triage, a suggested reply grounded in that listing's house rules and calendar, and reports on occupancy, blocked gaps and listing completeness. Rates come from the calendar or are reported as unknown. Nothing is sent.

Without credentials the server runs on bundled fixtures, so npx hostaway-kit works as a demo. Live reads need a Hostaway account id and API client secret. It is made by STYLABS, which says it is not an official Hostaway partner. Skills for Cursor, Claude Code and Codex are in the repository.

## Features

- **Listings and calendar:** Fetch active listings, one listing, and its calendar.
- **Reservations:** List reservations for stay checks.
- **Inbox triage:** Flag unanswered and slow threads against an SLA.
- **Draft replies:** Suggest a reply from the listing's fields and calendar without sending.
- **Field denylist:** Removes Wi-Fi, door code and invoicing fields from payloads.
- **Fixture demo:** Runs without credentials on sample data.

## Good for

- Find unanswered guest threads
- Spot blocked gaps in a calendar
- Check which listings lack photos or house rules
- Draft a reply to a booking question

## Install

### Claude Code (Terminal)

```sh
claude mcp add hostaway-kit --env HOSTAWAY_CLIENT_SECRET='<HOSTAWAY_CLIENT_SECRET>' -- npx -y hostaway-kit
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hostaway-kit": {
      "command": "npx",
      "args": [
        "-y",
        "hostaway-kit"
      ],
      "env": {
        "HOSTAWAY_CLIENT_SECRET": "<HOSTAWAY_CLIENT_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hostaway-kit": {
      "command": "npx",
      "args": [
        "-y",
        "hostaway-kit"
      ],
      "env": {
        "HOSTAWAY_CLIENT_SECRET": "<HOSTAWAY_CLIENT_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hostaway-kit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hostaway-kit"
      ],
      "env": {
        "HOSTAWAY_CLIENT_SECRET": "<HOSTAWAY_CLIENT_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hostaway-kit": {
      "command": "npx",
      "args": [
        "-y",
        "hostaway-kit"
      ],
      "env": {
        "HOSTAWAY_CLIENT_SECRET": "<HOSTAWAY_CLIENT_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hostaway-kit": {
      "command": "npx",
      "args": [
        "-y",
        "hostaway-kit"
      ],
      "env": {
        "HOSTAWAY_CLIENT_SECRET": "<HOSTAWAY_CLIENT_SECRET>"
      }
    }
  }
}
```

## Tools

- `list_listings`: List active listings.
- `get_listing`: Fetch one listing.
- `get_calendar`: Read a listing's calendar.
- `list_reservations`: List reservations.
- `list_conversations`: List guest conversations.
- `list_messages`: Read the messages in a conversation.

## FAQ

### Can it send messages or book stays?

No. Creating reservations and sending messages are out of scope.

### Do I need Hostaway credentials?

Only for live reads; without them it uses fixtures.

### Is it official?

STYLABS says it is not an official Hostaway partner.

### Which transport?

stdio only.

### Is hostaway-kit free?

Yes. hostaway-kit is free to use.

### How do I add hostaway-kit to Claude Code?

Run this command in your terminal: claude mcp add hostaway-kit --env HOSTAWAY_CLIENT_SECRET='<HOSTAWAY_CLIENT_SECRET>' -- npx -y hostaway-kit

### What are the best alternatives to hostaway-kit?

The closest alternatives to hostaway-kit are Ha MCP, Concord MCP, note1, Tutu eSIM and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/hostaway-kit
