ai.smithery/keithah-hostex-mcp
Manage your Hostex vacation rentals—properties, reservations, availability, listings, and guest me…
Open source Repository Open in the app JSON README (API)
About
Manage your Hostex vacation rentals—properties, reservations, availability, listings, and guest me…
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- ai.smithery
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.2.0
- Stars
- 1
- Last push
- 2026-08-13T14:44:42Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:00:39
- Updated
- 2026-08-29 03:00:39
- Origin id
ai.smithery/keithah-hostex-mcp
README
# hostex-mcp
[](https://github.com/keithah/hostex-mcp/actions/workflows/release.yml)
[](https://github.com/keithah/hostex-mcp/actions/workflows/check-npm-updates.yml)
[](https://smithery.ai/server/@keithah/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](https://www.npmjs.com/package/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:
```bash
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](https://github.com/keithah/hostex-mcp/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):
```json
{
"mcpServers": {
"hostex": {
"command": "npx",
"args": ["-y", "hostex-mcp"],
"env": {
"HOSTEX_ACCESS_TOKEN": "your_hostex_api_token"
}
}
}
}
```
Or use the Smithery hosted server:
```json
{
"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
```bash
# 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
```bash
# Start dev server with Smithery
npm run dev
```
## Architecture
This MCP server uses:
- **[@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk)** - MCP protocol implementation
- **[@smithery/sdk](https://www.npmjs.com/package/@smithery/sdk)** - Multi-transport support
- **[hostex-ts](https://www.npmjs.com/package/hostex-ts)** - Hostex API client library
- **[zod](https://www.npmjs.com/package/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](https://smithery.ai) 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](https://docs.hostex.io/)
- [hostex-ts npm package](https://www.npmjs.com/package/hostex-ts)
- [Model Context Protocol](https://modelcontextprotocol.io/)
## License
MIT
## Author
Keith Hadfield
## Support
- **Issues**: [GitHub Issues](https://github.com/keithah/hostex-mcp/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.