hostex-mcp

Model Context Protocol server for the Hostex property management API. Manage your vacation rental properties, reservations, guest communications, and more through Claude and other MCP clients.

Built on hostex-ts - TypeScript client library for Hostex API v3.0.0.

Features

• 🏠 Properties - Property and room type management
• 📅 Reservations - CRUD operations, custom fields, lock codes
• 📊 Availability - Property availability calendars
• 📋 Listings - Channel listings, pricing, inventory
• 💬 Messaging - Guest communication and messaging
• ⭐ Reviews - Review management and responses
• 🔗 Webhooks - Real-time event notifications
• ⚙️ Utilities - Custom channels and income methods

Available Tools (25+)

• hostex_list_properties - List all properties
• hostex_list_room_types - List room types
• hostex_list_reservations - Search and filter reservations
• hostex_create_reservation - Create direct bookings
• hostex_cancel_reservation - Cancel reservations
• hostex_update_lock_code - Update stay lock codes
• hostex_get_custom_fields - Get custom field values
• hostex_update_custom_fields - Update custom fields
• hostex_list_availabilities - Check property availability
• hostex_update_availabilities - Block/open dates
• hostex_list_conversations - List guest conversations
• hostex_get_conversation - Get conversation details
• hostex_send_message - Send messages to guests
• hostex_list_reviews - Query reviews
• hostex_create_review - Leave reviews or replies
• hostex_list_webhooks - List configured webhooks
• hostex_create_webhook - Register new webhooks
• hostex_delete_webhook - Remove webhooks
• hostex_get_listing_calendar - Get listing calendars
• hostex_update_listing_prices - Update channel prices
• hostex_list_custom_channels - List custom channels
• hostex_list_income_methods - List income methods

Installation

Option 1: Via Smithery (Recommended)

Install directly from Smithery:

npx -y @smithery/cli install @keithah/hostex-mcp --client claude

Or add the hosted server URL to your MCP client:

https://server.smithery.ai/@keithah/hostex-mcp/mcp

When prompted, provide your Hostex API access token.

Option 2: MCPB Package

1. Download the latest .mcpb file from Releases
2. Double-click the file to install in your MCP client
3. Configure your Hostex API token when prompted

Option 3: Manual Installation (Claude Desktop)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or ~/.config/Claude/claude_desktop_config.json on Linux):

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

Or use the Smithery hosted server:

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

Configuration

You need a Hostex API access token. Get yours from your Hostex account settings at https://www.hostex.io/

The server accepts configuration through the configSchema:

• accessToken (required): Your Hostex API access token

Usage Examples

Once installed, you can ask Claude natural language questions like:

• "Show me all my Hostex properties"
• "List reservations checking in this week"
• "Block property 12345 for next weekend"
• "Send a welcome message to the guest in conversation ABC123"
• "What reviews have I received this month?"
• "Create a direct booking for property XYZ"

Development

Prerequisites

• Node.js >= 18
• npm

Setup

# Clone the repository
git clone https://github.com/keithah/hostex-mcp.git
cd hostex-mcp

# Install dependencies
npm install

# Build for stdio transport
npm run build:stdio

# Build for streamable HTTP transport
npm run build:shttp

# Build both transports
npm run build:all

Testing Locally

# Start dev server with Smithery
npm run dev