hostex-mcp

Smithery

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

Architecture

This MCP server uses:

• @modelcontextprotocol/sdk - MCP protocol implementation
• @smithery/sdk - Multi-transport support
• hostex-ts - Hostex API client library
• zod - Schema validation

Transports

The server supports two transport protocols:

• stdio - Standard input/output (for local MCP clients like Claude Desktop)
• shttp - Streamable HTTP (for remote/web-based MCP clients)

Both are built using Smithery for seamless multi-transport support.

Automatic Updates

This repository includes a GitHub Actions workflow that:

1. Checks hourly for new releases of hostex-ts on npm
2. Automatically creates a PR to update the dependency
3. Bumps the patch version
4. Rebuilds the MCP bundles

When you merge the PR and create a new release tag, the MCPB package is automatically built and attached to the GitHub release.

Requirements

• Node.js >= 18
• MCP-compatible client (Claude Desktop v0.10.0+, or any MCP client)
• Hostex account with API access

Documentation

• Hostex API Documentation
• hostex-ts npm package
• Model Context Protocol

License

MIT

Author

Keith Hadfield

Support

• Issues: GitHub Issues
• Hostex API: https://docs.hostex.io/
• MCP Documentation: https://modelcontextprotocol.io/

Note: This is an unofficial community project and is not officially supported by Hostex.