Hostaway Mcp

by prosperkartik

284 downloads

Not rated

GitHub

Other

Description

# @prosperkartik/hostaway-mcp <p align="center"> <img src="./docs/hostaway-logo.png" alt="Hostaway" height="48" /> </p> > Model Context Protocol (MCP) server for the Hostaway PMS — connect Claude to your vacation rental ops. `@prosperkartik/hostaway-mcp` connects Claude (in…

About

Details

Author: prosperkartik
Downloads: 284
Categories: Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Hostaway Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

From the repository

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?”.

`list_listings`

List properties (listings) on the connected Hostaway account. Returns a compact Markdown table with id, name, location, bedrooms/bathrooms, person capacity, and status.

`get_listing`

Fetch full details for a single Hostaway listing by id. Returns location, capacity, pricing, reputation, and channel URLs as Markdown sections.

`list_reservations`

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.

`get_reservation`

Fetch full details for a single Hostaway reservation by id. Returns guest info, dates, pricing breakdown, and channel details.

`list_calendar`

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_conversations`

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_unread_conversations`

List only guest message threads that have unread messages. The most useful tool for answering 'do I have any guests waiting on a reply?'

`get_conversation_messages`

Fetch the full message history of a single conversation by id. Returns each message with direction (incoming/outgoing), timestamp, and body.

`list_owner_statements`

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.

`whoami`

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hostaway mcp": {
            "hostaway": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prosperkartik/hostaway-mcp"
                ],
                "env": {
                    "HOSTAWAY_ACCOUNT_ID": "your-account-id",
                    "HOSTAWAY_API_KEY": "your-api-key"
                }
            }
        }
    }
}

McpServers

{
    "hostaway": {
        "command": "npx",
        "args": [
            "-y",
            "@prosperkartik/hostaway-mcp"
        ],
        "env": {
            "HOSTAWAY_ACCOUNT_ID": "your-account-id",
            "HOSTAWAY_API_KEY": "your-api-key"
        }
    }
}

@prosperkartik/hostaway-mcp

> 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

claude mcp add hostaway \
  --scope user \
  -e HOSTAWAY_ACCOUNT_ID=your-account-id \
  -e HOSTAWAY_API_KEY=your-api-key \
  -- npx -y @prosperkartik/hostaway-mcp

(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:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@prosperkartik/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_API_KEY": "your-api-key"
      }
    }
  }
}

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."
- "What reservations are checking in next week?"
- "Is listing 12345 available May 10–17?"
- "Do I have any unread guest messages?"
- "Show me the conversation with [guest]."

Example output (placeholder data)

> List my Hostaway listings.
Found 3 listings:
| ID    | Name              | Location          | Beds | Baths | Capacity | Status |

|-------|-------------------|-------------------|------|-------|----------|--------|

| 10001 | Sample Apt 2BR    | Sample City, US   | 2    | 2     | 4        | active |

| 10002 | Sample Loft       | Sample City, US   | 1    | 1     | 2        | active |

| 10003 | Sample Beachfront | Sample Beach, US  | 3    | 2     | 6        | active |

```
> Is listing 10001 available May 10–17?

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

list_listings

get_listing

list_reservations

get_reservation

list_calendar

list_conversations

list_unread_conversations

get_conversation_messages

list_owner_statements

whoami

Claude Desktop / Cursor

McpServers

@prosperkartik/hostaway-mcp

Why this server

Tools (v0.1)

Quick start

1. Get your Hostaway API credentials

2. Add to Claude Code

3. Or add to Claude Desktop

4. Try it

Example output (placeholder data)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`list_listings`

`get_listing`

`list_reservations`

`get_reservation`

`list_calendar`

`list_conversations`

`list_unread_conversations`

`get_conversation_messages`

`list_owner_statements`

`whoami`