Hostaway Mcp

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.