Hostaway

io.github.uncfreak1255-code由 GitHub 帳號 uncfreak1255-code 發布v0.2.0更新於 Oct 24, 2026

Read-only MCP server for Hostaway PMS — guest conversations, reservations, and listings

已驗證STDIO僅桌面效率與工作流商業與電商

概覽

AI 產生的概覽

用於 Hostaway 物業管理的唯讀 MCP 伺服器，可查詢房客對話、訂房與房源。

可以做什麼
透過 Hostaway PMS API 提供六個唯讀工具：list_unread_guest_threads、get_conversation_context、get_reservation_brief、get_listing_brief、search_reservations 與 search_conversations。它針對旅宿業務情境設計，而非原始端點的簡單代理，重點在對話脈絡、訂房查詢與房源查詢。它不會傳送房客訊息，也不會修改訂房或房源。
適用情境
當助理需要查詢 Hostaway 的訂房、房源或房客對話脈絡，而不想每次手動呼叫原始 API 時使用。適合唯讀的分類處理與查詢流程，不適合傳送訊息或修改資料。
執行需求
透過 stdio 在本機執行，通常使用 npx hostaway-mcp 或已建置的 CLI。需要 Node.js，並透過環境變數 HOSTAWAY_API_TOKEN 提供 Hostaway API 權杖。選用的環境變數 HOSTAWAY_BASE_URL 可覆寫 API 基礎網址。需要連線至 Hostaway API 的網路存取。
安裝前請注意
此伺服器需要 HOSTAWAY_API_TOKEN 密鑰，可存取 Hostaway 帳戶資料；請勿將其寫入共用設定檔或提交至版本控制。它依設計為唯讀，不會傳送訊息或修改訂房、房源，但讀取的資料會傳送給助理及其模型供應商。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hostaway，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

hostaway-mcp

Read-only, hospitality-shaped MCP server for Hostaway.

This repo owns the operator product only: local/npm stdio, six read-only tools, no Cloudflare Worker, and no Seascape booking surface.

V1 Goal

Make Codex and Claude useful in real Hostaway workflows without hand-wiring raw API calls every time.

V1 is intentionally narrow:

  • read-only only
  • hospitality-native tools, not raw endpoint parity
  • optimized for conversation context, reservation lookup, and listing lookup

Exact V1 Surface

  • list_unread_guest_threads
  • get_conversation_context
  • get_reservation_brief
  • get_listing_brief
  • search_reservations
  • search_conversations

Local Development

bash
npm installnpm testnpm run checknpm run build

Run the stdio server locally:

bash
HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js

Create a local npm package tarball:

bash
npm pack

After publish, run without cloning:

bash
npx hostaway-mcp

MCP Client Wiring

For local MCP clients, provide HOSTAWAY_API_TOKEN through the environment and spawn the published npm package over stdio.

The snippets below are pinned to the current published version:

text
[email protected]

Update that version intentionally when you upgrade.

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json.

If you already have top-level keys like preferences, keep them and add mcpServers alongside them:

json
{  "mcpServers": {    "hostaway": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "HOSTAWAY_API_TOKEN": "your-token-here"      }    }  }}

Restart Claude Desktop after saving the file.

Codex

Edit ~/.codex/config.toml and add:

toml
[mcp_servers.hostaway]command = "npx"args = ["-y", "[email protected]"]
[mcp_servers.hostaway.env]HOSTAWAY_API_TOKEN = "your-token-here"

Verify the server is registered:

bash
codex mcp list

Local Built CLI

If you want to run the repo checkout instead of npm, point the client at the built CLI directly:

json
{  "command": "node",  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],  "env": {    "HOSTAWAY_API_TOKEN": "your-token-here"  }}

Environment Variables

VariableRequiredDefaultDescription
HOSTAWAY_API_TOKENYes—Hostaway API token used to authenticate all requests.
HOSTAWAY_BASE_URLNoHostaway production URLOverride the API base URL (useful for testing).

V1 Non-Goals

  • sending guest messages
  • mutating reservations or listings
  • Cloudflare Worker transport
  • Seascape booking/distribution flows
  • webhook ingestion
  • background sync pipelines
  • dashboards or owner reporting
  • generic REST-to-MCP proxy coverage

Source Design

See docs/designs/v1-readonly-hostaway-mcp.md.

來源：README.md，提交 7708f14

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分