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 propertieshostex_list_room_types- List room typeshostex_list_reservations- Search and filter reservationshostex_create_reservation- Create direct bookingshostex_cancel_reservation- Cancel reservationshostex_update_lock_code- Update stay lock codeshostex_get_custom_fields- Get custom field valueshostex_update_custom_fields- Update custom fieldshostex_list_availabilities- Check property availabilityhostex_update_availabilities- Block/open dateshostex_list_conversations- List guest conversationshostex_get_conversation- Get conversation detailshostex_send_message- Send messages to guestshostex_list_reviews- Query reviewshostex_create_review- Leave reviews or replieshostex_list_webhooks- List configured webhookshostex_create_webhook- Register new webhookshostex_delete_webhook- Remove webhookshostex_get_listing_calendar- Get listing calendarshostex_update_listing_prices- Update channel priceshostex_list_custom_channels- List custom channelshostex_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
- Download the latest
.mcpbfile from Releases - Double-click the file to install in your MCP client
- 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:
- Checks hourly for new releases of
hostex-tson npm - Automatically creates a PR to update the dependency
- Bumps the patch version
- 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
- 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.