hostaway-kit
Read-only Hostaway access for listings, calendars, inbox triage and simple reports
- 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-kitAdd 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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

Tutu eSIM
MCP serverLive travel eSIM plans, prices and roaming costs for 190+ countries
- 5 tools
- Remote
- Paid
- Maps and travel

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

Shanghai Streets Travel Guide
MCP serverCurated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang
- 9 tools
- Remote
- Free
- Maps and travel