Submit
keithah

hostex-mcp

Community keithah
Updated

Model Context Protocol server for Hostex property management API - supports stdio and streamable HTTP

hostex-mcp

ReleaseCheck hostex-ts UpdatesSmithery

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:

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

License

MIT

Author

Keith Hadfield

Support

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

MCP Server · Populars

MCP Server · New