广告合作
MCP.so
登录

Hostaway MCP Server

@prosperkartik

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

prosperkartik

提交者

prosperkartik

关于 Hostaway MCP Server

暂无概览

#hostaway#vacation-rental#pms#hospitality#short-term-rental#str#claude#mcp#typescript#airbnb#vrbo

Hostaway MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Hostaway MCP Server 工具

10

List 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.

概览

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

常见问题

1

What credentials do I need?

Your Hostaway Account ID and API Key from **Settings → Hostaway API**. No separate bearer token generation is needed.

2

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.

3

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.

4

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.

5

Is this project affiliated with Hostaway Inc.?

No. This is a community-built project and is not endorsed by or affiliated with Hostaway Inc.

评论

其他 分类下的更多 MCP 服务器

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples 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

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

广告合作