About Hostaway MCP by usefulapi
Hostaway MCP by usefulapi is a hosted server for accommodation operators using Hostaway. It brings read and selected write operations for listings, reservations, calendars, guest communications, and operations into MCP clients, with no local installation.
Key features
- 01Browse listings and reservations
- 02Read calendars and price quotes
- 03Review conversations and guest feedback
- 04Create and update reservations
- 05Update calendars and message guests
- 06Create and manage tasks
Use cases
- 01Check availability and quote a stay
- 02Review reservation changes and guest conversations
- 03Create or update a reservation
- 04Send a guest message or assign a task
MCP support
Exposes Hostaway data and operations as tools for MCP clients, including reservation, calendar, messaging, and task actions. It runs as a hosted remote server and uses Hostaway account credentials.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://hostaway.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-hostaway https://hostaway.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-hostaway":{"serverUrl":"https://hostaway.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
20| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | No | City. |
| limit | integer | No | Maximum records to return (1-500). |
| match | string | No | Search by listing name. |
| offset | integer | No | Records to skip from the start. |
| country | string | No | Country. |
| sortOrder | enum | No | Sort order.name | nameReversed | order | orderReversed | contactName | contactNameReversed | latestActivity | latestActivityDesc |
| specialStatus | array | No | Filter by status; omit for both active and archived. |
| propertyTypeId | integer | No | Property type id. |
| includeResources | boolean | No | Include attached sub-resources (sent as includeResources=1). |
| availabilityDateEnd | string | No | Only listings available until (YYYY-MM-DD). |
| availabilityDateStart | string | No | Only listings available from (YYYY-MM-DD). |
| availabilityGuestNumber | integer | No | Only listings that fit this many guests. |
Details
From the project READMEHostaway MCP by usefulapi
Use Hostaway from Claude, Cursor, or any MCP client — read listings, reservations, calendars, conversations, reviews and owner statements, and create reservations, update calendars, message guests and manage tasks. Hosted, no local install: connect with your own Hostaway credentials.
Live endpoint: https://hostaway.usefulapi.io/mcp · Homepage: https://usefulapi.io/hostaway
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://hostaway.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http hostaway https://hostaway.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"hostaway": {
"url": "https://hostaway.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Hostaway credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/hostaway/
On first connect you'll provide your Hostaway account ID and API key (Settings → Hostaway API). They're validated, stored per-user, and scoped to you — no keys in config files.
Tools
| Tool | Type | What it does |
|---|---|---|
hostaway_list_listings | read | List listings |
hostaway_get_listing | read | Get one listing |
hostaway_list_reservations | read | List reservations |
hostaway_get_reservation | read | Get one reservation |
hostaway_get_reservation_logs | read | Get reservation change history |
hostaway_get_calendar | read | Get listing calendar |
hostaway_calculate_price | read | Quote a stay |
hostaway_list_conversations | read | List guest conversations |
hostaway_list_conversation_messages | read | Read a conversation |
hostaway_list_reviews | read | List reviews |
hostaway_list_tasks | read | List tasks |
hostaway_list_expenses | read | List expenses and extras |
hostaway_list_owner_statements | read | List owner statements |
hostaway_get_owner_statement | read | Get one owner statement |
hostaway_create_reservation | write | Create a reservation |
hostaway_update_reservation | write | Update a reservation |
hostaway_update_calendar | write | Update listing calendar |
hostaway_send_message | write | Send a guest message |
hostaway_create_task | write | Create a task |
hostaway_update_task | write | Update a task |
hostaway_usage_status | meta | Usage status (free-tier meter) |
hostaway_request_feature | meta | Request a missing feature |
hostaway_upgrade | meta | Upgrade to Pro (unlimited*) |
hostaway_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per user) | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with hostaway_upgrade (it returns a Stripe Checkout link). Cancel any time with hostaway_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running hostaway_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT © usefulapi. Not affiliated with or endorsed by Hostaway.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.