hostaway

hostaway-mcp

Hostaway 向けの、ホスピタリティ業界に特化した読み取り専用 MCP サーバーです。

このリポジトリが担うのはオペレーター向けプロダクトのみです。ローカル/npm の stdio、読み取り専用ツール 6 種類を提供し、Cloudflare Worker と Seascape の予約機能は含みません。

V1 の目標

毎回、生の API 呼び出しを手作業で組み立てなくても、実際の Hostaway ワークフローで Codex と Claude を活用できるようにします。

V1 の範囲は意図的に限定しています。

• 読み取り専用のみ
• 生のエンドポイントと同等の機能ではなく、ホスピタリティ業界に特化したツール
• 会話コンテキスト、予約検索、リスティング検索に最適化

V1 の正確な提供範囲

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

ローカル開発

npm install
npm test
npm run check
npm run build

stdio サーバーをローカルで実行します。

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

ローカルの npm パッケージ tarball を作成します。

npm pack

公開後は、クローンせずに実行できます。

npx hostaway-mcp

MCP クライアントの接続設定

ローカルの MCP クライアントでは、HOSTAWAY_API_TOKEN を環境変数で渡し、公開済みの npm パッケージを stdio 経由で起動します。

以下のスニペットは、現在公開されているバージョンに固定されています。

[email protected]

アップグレード時は、意図的にこのバージョンを更新してください。

Claude Desktop（macOS）

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

preferences などのトップレベルキーがすでにある場合は、それらを残したまま、同じ階層に mcpServers を追加します。

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

ファイルを保存した後、Claude Desktop を再起動してください。

Codex

~/.codex/config.toml を編集して、次を追加します。

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "[email protected]"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

サーバーが登録されていることを確認します。

codex mcp list

ローカルでビルドした CLI

npm ではなくリポジトリのチェックアウトを実行する場合は、ビルド済み CLI をクライアントに直接指定します。

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

環境変数

変数	必須	デフォルト	説明
HOSTAWAY_API_TOKEN	はい	—	すべてのリクエストの認証に使用する Hostaway API トークンです。
HOSTAWAY_BASE_URL	いいえ	Hostaway の本番 URL	API のベース URL を上書きします（テストに便利です）。

V1 の対象外

• ゲストへのメッセージ送信
• 予約やリスティングの変更
• Cloudflare Worker によるトランスポート
• Seascape の予約／配信ワークフロー
• Webhook の取り込み
• バックグラウンド同期パイプライン
• ダッシュボードやオーナー向けレポート
• 汎用 REST-to-MCP プロキシの網羅

ソース設計

docs/designs/v1-readonly-hostaway-mcp.md を参照してください。