Hostex

You can run the Hostex Model Context Protocol server to access Hostex data through MCP clients like Claude. It lets you manage properties, reservations, availability, listings, messaging, reviews, webhooks, and related utilities via a consistent MCP interface.

How to use

Introduce Claude and other MCP clients to your Hostex data by configuring an MCP server that points to a hosted endpoint or runs locally. Use the MCP client to ask questions and issue actions such as listing properties, checking reservations, blocking dates, messaging guests, or updating prices. You can switch between a remote MCP server (HTTP) and a local stdio transport, depending on your client setup. Ensure you have your Hostex API access token ready to authorize requests.

Typical usage patterns include asking Claude things like: show my properties, list reservations for the coming week, block dates for a property, send a welcome message to a guest, or create a direct booking. The MCP server translates your natural language requests into Hostex API actions behind the scenes.

How to install

Prerequisites you need before installing: Node.js version 18 or newer, and npm.

# Option 1. Install via Smithery (Recommended)
npx -y @smithery/cli install @keithah/hostex-mcp --client claude

# Optional: use the hosted MCP URL with your MCP client when prompted
# Example hosted URL for Claude or other MCP clients:
https://server.smithery.ai/@keithah/hostex-mcp/mcp

Option 2 lets you install a packaged MCP bundle and configure your token when prompted.

Option 3. Manual installation for Claude Desktop

• Add a local stdio MCP server entry to Claude Desktop configuration.
• Or use the Smithery hosted server URL for an HTTP transport.

{
  "mcpServers": {
    "hostex": {
      "command": "npx",
      "args": ["-y", "hostex-mcp"],
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

If you prefer the hosted server, configure Claude Desktop to point to the Smithery URL.

{
  "mcpServers": {
    "hostex": {
      "url": "https://server.smithery.ai/@keithah/hostex-mcp/mcp",
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

Additional sections

Configuration notes: you need a Hostex API access token. Obtain it from your Hostex account settings. The MCP server accepts configuration via the configSchema with an accessToken field.

Usage tips: after installation, you can ask natural language questions like: show me all my Hostex properties, list reservations for this week, block dates for a property, send a welcome message to a guest, or check reviews for the current month.

Development and tooling: Node.js v18+ and npm are required. You may build and run transports (stdio and shttp) as part of the development workflow.

Configuration

You must provide a Hostex API access token. The token gives the MCP server permission to access your Hostex data.

The following MCP server configurations are available for this integration.

{
  "mcpServers": {
    "hostex": {
      "url": "https://server.smithery.ai/@keithah/hostex-mcp/mcp",
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

{
  "mcpServers": {
    "hostex": {
      "command": "npx",
      "args": ["-y", "hostex-mcp"],
      "env": {
        "HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
      }
    }
  }
}

Examples and notes

Common actions include listing properties, creating reservations, updating lock codes, and sending guest messages. You can also manage calendars, channel listings, and reviews through the MCP interface.

Available tools

hostex_list_properties

List all properties in Hostex for your MCP client to display.

hostex_list_room_types

List room types for properties to help categorize reservations.

hostex_list_reservations

Search and filter reservations with optional criteria.

hostex_create_reservation

Create a direct booking for a property.

hostex_cancel_reservation

Cancel an existing reservation.

hostex_update_lock_code

Update the stay lock codes for check-in.

hostex_get_custom_fields

Retrieve custom field values for reservations and guests.

hostex_update_custom_fields

Update custom fields on reservations or guests.

hostex_list_availabilities

Check property availability calendars.

hostex_update_availabilities

Block or open dates on the calendar.

hostex_list_conversations

List guest conversations.

hostex_get_conversation

Get details for a specific conversation.

hostex_send_message

Send messages to guests within a conversation.

hostex_list_reviews

Query guest reviews.

hostex_create_review

Leave reviews or responses.

hostex_list_webhooks

List configured webhooks.

hostex_create_webhook

Register new webhooks.

hostex_delete_webhook

Remove webhooks.

hostex_get_listing_calendar

Get listing calendars for channels.

hostex_update_listing_prices

Update channel prices.

hostex_list_custom_channels

List custom channels.

hostex_list_income_methods

List income methods.