Official description7 sourcesMCP servers8d ago
prosperkartik/hostaway-mcp
Read-only access to
View on GitHub ↗Direct link · no redirect page
Config template (adjust for your client)
claude mcp add hostaway-mcp -- npx -y hostaway-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 4 ★ · prosperkartik/hostaway-mcp · read from the GitHub search API · (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
- Score
- score 703 · 4 ★ · 7 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
prosperkartik/hostaway-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.Third-party quality signals
@prosperkartik/hostaway-mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
> Model Context Protocol (MCP) server for the Hostaway PMS — connect Claude to your vacation rental ops.
@prosperkartik/hostaway-mcp connects Claude (in Claude Code, Claude Desktop, or any MCP-compatible client) to your Hostaway account — listings, reservations, calendar availability, guest messaging, and financials. Authored by an engineer who has integrated Hostaway, Ciirus, and major OTA APIs (Airbnb, VRBO, Booking.com, Expedia, Marriott) in production for short-term rental operators since 2022.
> _Hostaway is a trademark of Hostaway Inc. This project is community-built and not affiliated with or endorsed by Hostaway._
Why this server
Three reasons:
1. **Tool coverage.** 10 read-only tools across listings, reservations, calendar, conversations, financials, and a health-check — broader surface than other community MCP servers in this space.
2. **Cleaner auth UX.** Takes the two credentials Hostaway gives you on the API settings page — Account ID + API Key — and handles the OAuth token exchange internally. No "go generate a bearer token elsewhere first" step.
3. **Built by someone who works the API.** The author has 3+ years of production Hostaway / Ciirus integration work behind the design decisions. Tools map to real operator workflows, not just REST endpoints.
Tools (v0.1)
All v0.1 tools are **read-only**. Write operations are coming in later versions, gated behind explicit confirmation.
| Tool | Description |
|---|---|
| whoami | Health-check — returns connected account counts (listings, reservations, conversations, owner statements, users). Run this first to confirm setup works. |
| list_listings | List properties on the account |
| get_listing | Full detail for a single listing — location, capacity, pricing, reputation, channel URLs |
| list_reservations | List reservations, with optional filters by arrival date range and status |
| get_reservation | Full detail for a single reservation — guest, dates, pricing, channel |
| list_calendar | Per-day availability for a listing across a date range — answers *"is property X free between A and B?"* |
| list_conversations | List guest message threads with unread state and last activity |
| list_unread_conversations | Only conversations with unread guest messages — answers *"who's waiting on a reply?"* |
| get_conversation_messages | Full message history of a single conversation |
| list_owner_statements | List owner financial statements |
Quick start
1. Get your Hostaway API credentials
In your Hostaway operator account → **Settings → Hostaway API**. Generate API credentials. You'll get an **Account ID** and an **API Key**.
2. Add to Claude Code
(Or use --scope local to install for the current project only.)
3. Or add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:
Restart Claude Desktop. The Hostaway tools appear in the tools picker.
4. Try it
Ask Claude things like:
- *"Run whoami to confirm Hostaway is connected."*
- *"List my Hostaway listings."*
@prosperkartik/hostaway-mcp connects Claude (in Claude Code, Claude Desktop, or any MCP-compatible client) to your Hostaway account — listings, reservations, calendar availability, guest messaging, and financials. Authored by an engineer who has integrated Hostaway, Ciirus, and major OTA APIs (Airbnb, VRBO, Booking.com, Expedia, Marriott) in production for short-term rental operators since 2022.
> _Hostaway is a trademark of Hostaway Inc. This project is community-built and not affiliated with or endorsed by Hostaway._
Why this server
Three reasons:
1. **Tool coverage.** 10 read-only tools across listings, reservations, calendar, conversations, financials, and a health-check — broader surface than other community MCP servers in this space.
2. **Cleaner auth UX.** Takes the two credentials Hostaway gives you on the API settings page — Account ID + API Key — and handles the OAuth token exchange internally. No "go generate a bearer token elsewhere first" step.
3. **Built by someone who works the API.** The author has 3+ years of production Hostaway / Ciirus integration work behind the design decisions. Tools map to real operator workflows, not just REST endpoints.
Tools (v0.1)
All v0.1 tools are **read-only**. Write operations are coming in later versions, gated behind explicit confirmation.
| Tool | Description |
|---|---|
| whoami | Health-check — returns connected account counts (listings, reservations, conversations, owner statements, users). Run this first to confirm setup works. |
| list_listings | List properties on the account |
| get_listing | Full detail for a single listing — location, capacity, pricing, reputation, channel URLs |
| list_reservations | List reservations, with optional filters by arrival date range and status |
| get_reservation | Full detail for a single reservation — guest, dates, pricing, channel |
| list_calendar | Per-day availability for a listing across a date range — answers *"is property X free between A and B?"* |
| list_conversations | List guest message threads with unread state and last activity |
| list_unread_conversations | Only conversations with unread guest messages — answers *"who's waiting on a reply?"* |
| get_conversation_messages | Full message history of a single conversation |
| list_owner_statements | List owner financial statements |
Quick start
1. Get your Hostaway API credentials
In your Hostaway operator account → **Settings → Hostaway API**. Generate API credentials. You'll get an **Account ID** and an **API Key**.
2. Add to Claude Code
(Or use --scope local to install for the current project only.)
3. Or add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:
Restart Claude Desktop. The Hostaway tools appear in the tools picker.
4. Try it
Ask Claude things like:
- *"Run whoami to confirm Hostaway is connected."*
- *"List my Hostaway listings."*
- Source
- awesome · https://github.com/prosperkartik/hostaway-mcp
- Browse by field
- MCP servers
- Traction
- 4 ★
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.