Hostaway

authSTDIOregistry active

Summary

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.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

ego lite browser

Fastest browser for AI agents to run web automation tasks, always free.

Download Free life-time →

Granola, the best AI meeting recorder

Notes, actions and memory. Without a meeting bot. First month 100% off.

Download for free →

CodeHealth MCP Server

Protect your code quality, stop the AI slop.

Try For Free →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Agent, connect blockchain

Connect your Claude agent to live crypto prices and trading routes via 1inch

Get the MCP →

Block distraction from your iPhone for free

Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.

Block now (100% free) →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

ego lite browser

Fastest browser for AI agents to run web automation tasks, always free.

Download Free life-time →

Granola, the best AI meeting recorder

Notes, actions and memory. Without a meeting bot. First month 100% off.

Download for free →

CodeHealth MCP Server

Protect your code quality, stop the AI slop.

Try For Free →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Agent, connect blockchain

Connect your Claude agent to live crypto prices and trading routes via 1inch

Get the MCP →

Block distraction from your iPhone for free

Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.

Block now (100% free) →

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:

hostaway-mcp@0.2.0

Update that version intentionally when you upgrade.

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json.

If you already have top-level keys like preferences, keep them and add mcpServers alongside them:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving the file.

Codex

Edit ~/.codex/config.toml and add:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

Verify the server is registered:

codex mcp list

Local Built CLI

If you want to run the repo checkout instead of npm, point the client at the built CLI directly:

{
  "command": "node",
  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
  "env": {
    "HOSTAWAY_API_TOKEN": "your-token-here"
  }
}

Environment Variables

Variable	Required	Default	Description
`HOSTAWAY_API_TOKEN`	Yes	—	Hostaway API token used to authenticate all requests.
`HOSTAWAY_BASE_URL`	No	Hostaway production URL	Override the API base URL (useful for testing).

V1 Non-Goals

sending guest messages
mutating reservations or listings
Cloudflare Worker transport
Seascape booking/distribution flows
webhook ingestion
background sync pipelines
dashboards or owner reporting
generic REST-to-MCP proxy coverage

Source Design

See docs/designs/v1-readonly-hostaway-mcp.md.

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

ego lite browser

Fastest browser for AI agents to run web automation tasks, always free.

Download Free life-time →

Granola, the best AI meeting recorder

Notes, actions and memory. Without a meeting bot. First month 100% off.

Download for free →

CodeHealth MCP Server

Protect your code quality, stop the AI slop.

Try For Free →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Agent, connect blockchain

Connect your Claude agent to live crypto prices and trading routes via 1inch

Get the MCP →

Block distraction from your iPhone for free

Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.

Block now (100% free) →

Configuration

HOSTAWAY_API_TOKEN*secret

Hostaway API token used to authenticate all requests

Registryactive

Packagehostaway-mcp

TransportSTDIO

AuthRequired

UpdatedApr 19, 2026

View on GitHub

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:

hostaway-mcp@0.2.0

Update that version intentionally when you upgrade.

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json.

If you already have top-level keys like preferences, keep them and add mcpServers alongside them:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving the file.

Codex

Edit ~/.codex/config.toml and add:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

Verify the server is registered:

codex mcp list

Local Built CLI

If you want to run the repo checkout instead of npm, point the client at the built CLI directly:

{
  "command": "node",
  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
  "env": {
    "HOSTAWAY_API_TOKEN": "your-token-here"
  }
}

Environment Variables

Variable	Required	Default	Description
`HOSTAWAY_API_TOKEN`	Yes	—	Hostaway API token used to authenticate all requests.
`HOSTAWAY_BASE_URL`	No	Hostaway production URL	Override the API base URL (useful for testing).

V1 Non-Goals

sending guest messages
mutating reservations or listings
Cloudflare Worker transport
Seascape booking/distribution flows
webhook ingestion
background sync pipelines
dashboards or owner reporting
generic REST-to-MCP proxy coverage

Source Design

See docs/designs/v1-readonly-hostaway-mcp.md.