English Français العربية

io.github.uncfreak1255-code/hostaway

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hostaway": {
            "command": "npx",
            "args": [
                "-y",
                "hostaway-mcp@0.2.0"
            ],
            "env": {
                "HOSTAWAY_API_TOKEN": "<your hostaway_api_token>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.uncfreak1255-code/hostaway ?

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

Comment installer io.github.uncfreak1255-code/hostaway ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hostaway -e 'HOSTAWAY_API_TOKEN=<your hostaway_api_token>' -- npx -y hostaway-mcp@0.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.uncfreak1255-code/hostaway ?

Oui. Il attend HOSTAWAY_API_TOKEN, à renseigner dans sa configuration.

io.github.uncfreak1255-code/hostaway est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.uncfreak1255-code/hostaway ?

Il est publié par uncfreak1255-code. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.