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

Related MCP server: Lodgify MCP Server

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.