Skip to content
MCP server

hostaway-kit

Read-only Hostaway access for listings, calendars, inbox triage and simple reports

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI
Runs
Locally
Version
1.0.2
Listing updated
2 days ago

About hostaway-kit

hostaway-kit is a free MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HOSTAWAY_ACCOUNT_IDHostaway account id. Optional: omit both credentials to run fixtures.
  • HOSTAWAY_CLIENT_SECRETHostaway API client secret. Optional: omit both credentials to run fixtures.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free npm package; needs your own Hostaway API access

Prices change. Check stylabs.com before you buy.

hostaway-kit 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 to hostaway-kit

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel