Hostaway Mcp
@prosperkartik
About Hostaway Mcp
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"hostaway": {
"command": "npx",
"args": [
"-y",
"@prosperkartik/hostaway-mcp"
],
"env": {
"HOSTAWAY_ACCOUNT_ID": "your-account-id",
"HOSTAWAY_API_KEY": "your-api-key"
}
}
}
}Tools
10List properties (listings) on the connected Hostaway account. Returns a compact Markdown table with id, name, location, bedrooms/bathrooms, person capacity, and status.
Fetch full details for a single Hostaway listing by id. Returns location, capacity, pricing, reputation, and channel URLs as Markdown sections.
List reservations on the connected Hostaway account. Optional filters by arrival date range and reservation status. Returns a Markdown table with the most useful operational fields.
Fetch full details for a single Hostaway reservation by id. Returns guest info, dates, pricing breakdown, and channel details.
Get the availability calendar for a single listing across a date range. Returns per-day availability, status, price, minimum stay, and reserved/blocked counts. Use this to answer 'is property X available between dates A and B?'
List guest message threads (conversations) on the connected Hostaway account. Returns a compact Markdown table with conversation id, guest, linked listing/reservation, unread state, and last activity time.
List only guest message threads that have unread messages. The most useful tool for answering 'do I have any guests waiting on a reply?'
Fetch the full message history of a single conversation by id. Returns each message with direction (incoming/outgoing), timestamp, and body.
List owner financial statements on the connected Hostaway account. Returns a compact table of statement id, name, and status. Useful for revenue and payout reporting.
Health-check tool — confirms credentials work and returns a quick summary of the connected Hostaway account: counts of listings, reservations, conversations, owner statements, and users. Use this first when setting up to verify the connection.
Overview
What is Hostaway MCP?
Hostaway MCP is a Model Context Protocol server that connects Claude (in Claude Code, Claude Desktop, or any MCP-compatible client) to your Hostaway vacation rental operations. It provides 10 read-only tools for listings, reservations, calendar availability, guest messaging, and financials, built by an engineer with production Hostaway integration experience.
How to use Hostaway MCP?
Install by adding the server via npx -y @prosperkartik/hostaway-mcp and setting the environment variables HOSTAWAY_ACCOUNT_ID and HOSTAWAY_API_KEY. Configure in Claude Code with claude mcp add or in Claude Desktop via claude_desktop_config.json. Then ask natural language questions like “List my listings” or “Is listing X available May 10–17?”.
Key features of Hostaway MCP
- 10 read-only tools covering listings, reservations, calendar, conversations, financials, and health-check
- Clean auth: supply Account ID and API Key; the server handles the OAuth token exchange internally
- Built by an engineer with three years of production Hostaway and OTA integration work
- All v0.1 tools are read-only; no mutation of Hostaway data
- Credentials live only in environment variables; bearer token cached in process memory
Use cases of Hostaway MCP
- Check reservation status and upcoming check-ins
- Query per-day availability for a listing across a date range
- View unread guest messages and full conversation history
- List all properties on the account with location, pricing, and capacity details
- Retrieve owner financial statements
FAQ from Hostaway MCP
What credentials do I need?
Your Hostaway Account ID and API Key from Settings → Hostaway API. No separate bearer token generation is needed.
Is this server read-only?
Yes, all v0.1 tools are read-only. Write operations (send messages, update calendar, create tasks) are planned for future versions and will require explicit confirmation.
How are credentials handled?
Credentials are passed via environment variables only. The server exchanges them for a bearer token that is stored in process memory; nothing is written to disk.
What transport does it use?
The server uses MCP’s stdio transport and communicates with the Hostaway REST API over HTTPS. No additional network configuration is required.
Is this project affiliated with Hostaway Inc.?
No. This is a community-built project and is not endorsed by or affiliated with Hostaway Inc.
Frequently asked questions
What credentials do I need?
Your Hostaway Account ID and API Key from **Settings → Hostaway API**. No separate bearer token generation is needed.
Is this server read-only?
Yes, all v0.1 tools are read-only. Write operations (send messages, update calendar, create tasks) are planned for future versions and will require explicit confirmation.
How are credentials handled?
Credentials are passed via environment variables only. The server exchanges them for a bearer token that is stored in process memory; nothing is written to disk.
What transport does it use?
The server uses MCP’s stdio transport and communicates with the Hostaway REST API over HTTPS. No additional network configuration is required.
Is this project affiliated with Hostaway Inc.?
No. This is a community-built project and is not endorsed by or affiliated with Hostaway Inc.
Basic information
More Other MCP servers
Awesome Mlops
visengerA curated list of references for MLOps
Nginx UI
0xJackyYet another WebUI for Nginx
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
Comments