uncfreak1255-code avatar

Hostaway

uncfreak1255-code/hostaway-mcp

Connects to the Hostaway property management system with six read-only tools built for hospitality workflows: list unread guest threads, pull conversation context, look up reservation and listing details, and search across both conversations and bookings. You pass a Hostaway API token through the environment and get Claude or Codex access to guest communication and reservation data without writing raw API calls. Intentionally narrow scope: no mutations, no message sending, no booking changes. If you're running a short-term rental operation on Hostaway and want LLM help triaging guest messages or looking up reservation details, this gives you the primitives.

tools
6
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 19, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

list_unread_guest_threadsRead-only, hospitality-shaped MCP server for Hostaway.

Read-only, hospitality-shaped MCP server for Hostaway.

No parameter schema in public metadata yet.

get_conversation_context

No parameter schema in public metadata yet.

get_reservation_brief

No parameter schema in public metadata yet.

get_listing_brief

No parameter schema in public metadata yet.

search_reservations

No parameter schema in public metadata yet.

search_conversations

No parameter schema in public metadata yet.

Sponsors

Configuration

HOSTAWAY_API_TOKEN*secret

Hostaway API token used to authenticate all requests

Readme

hostaway-mcp

Read-only, hospitality-shaped MCP server for Hostaway.

This repo owns the operator product only: local/npm stdio, six read-only tools, no Cloudflare Worker, and no Seascape booking surface.

V1 Goal

Make Codex and Claude useful in real Hostaway workflows without hand-wiring raw API calls every time.

V1 is intentionally narrow:

  • read-only only
  • hospitality-native tools, not raw endpoint parity
  • optimized for conversation context, reservation lookup, and listing lookup

Exact V1 Surface

  • list_unread_guest_threads
  • get_conversation_context
  • get_reservation_brief
  • get_listing_brief
  • search_reservations
  • search_conversations

Local Development

npm install
npm test
npm run check
npm run build

Run the stdio server locally:

HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js

Create a local npm package tarball:

npm pack

After publish, run without cloning:

npx hostaway-mcp

MCP Client Wiring

For local MCP clients, provide HOSTAWAY_API_TOKEN through the environment and spawn the published npm package over stdio.

The snippets below are pinned to the current published version:


View the full README on GitHub

Details

Repository
github.com/uncfreak1255-code/hostaway-mcp
Package
hostaway-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active