English Français العربية

io.github.uncfreak1255-code/hostaway

Official registry Other

Read-only MCP server for Hostaway PMS — guest conversations, reservations, and listings

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package hostaway-mcp
Claude Code 
claude mcp add hostaway -e 'HOSTAWAY_API_TOKEN=<your hostaway_api_token>' -- npx -y hostaway-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hostaway": {
            "command": "npx",
            "args": [
                "-y",
                "hostaway-mcp@0.2.0"
            ],
            "env": {
                "HOSTAWAY_API_TOKEN": "<your hostaway_api_token>"
            }
        }
    }
}

Environment variables

  • HOSTAWAY_API_TOKEN required secret Hostaway API token used to authenticate all requests

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. hostaway-mcp
  2. V1 Goal
  3. Exact V1 Surface
  4. Local Development
  5. MCP Client Wiring
  6. Environment Variables
  7. V1 Non-Goals
  8. Source Design

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

VariableRequiredDefaultDescription
HOSTAWAY_API_TOKENYes—Hostaway API token used to authenticate all requests.
HOSTAWAY_BASE_URLNoHostaway production URLOverride 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.

Frequently asked questions

What is io.github.uncfreak1255-code/hostaway?

Read-only MCP server for Hostaway PMS — guest conversations, reservations, and listings

How do I install io.github.uncfreak1255-code/hostaway?

It runs on your machine. In Claude Code: claude mcp add hostaway -e 'HOSTAWAY_API_TOKEN=<your hostaway_api_token>' -- npx -y hostaway-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.uncfreak1255-code/hostaway need an API key?

Yes. It expects HOSTAWAY_API_TOKEN, which you set in its configuration.

Is io.github.uncfreak1255-code/hostaway open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.uncfreak1255-code/hostaway?

It is published by uncfreak1255-code. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.