Hostaway Mcp

@prosperkartik/hostaway-mcp

Hostaway PMS 用の Model Context Protocol（MCP）サーバーです。Claude をバケーションレンタル業務に接続します。

@prosperkartik/hostaway-mcp は、Claude（Claude Code、Claude Desktop、または MCP 対応クライアント）を Hostaway アカウントに接続し、リスティング、予約、カレンダーの空き状況、ゲストとのメッセージ、財務情報を扱えるようにします。2022 年以降、短期レンタル事業者向けに Hostaway、Ciirus、および主要 OTA（Airbnb、VRBO、Booking.com、Expedia、Marriott）の API を本番環境で統合してきたエンジニアが作成しました。

Hostaway は Hostaway Inc. の商標です。このプロジェクトはコミュニティによって構築されたものであり、Hostaway との提携や承認を受けていません。

このサーバーを選ぶ理由

理由は 3 つあります。

1. ツールの網羅性。 リスティング、予約、カレンダー、会話、財務情報、ヘルスチェックにわたる 10 個の読み取り専用ツールを備えており、この分野の他のコミュニティ MCP サーバーより幅広い範囲をカバーします。
2. より簡潔な認証 UX。 Hostaway の API 設定ページで提供される 2 つの認証情報（Account ID と API Key）を受け取り、OAuth トークンの交換を内部で処理します。「先に別の場所でベアラートークンを生成する」手順は不要です。
3. API を使いこなす人が開発。 設計上の判断には、作者による 3 年以上の Hostaway／Ciirus の本番環境での統合経験が反映されています。ツールは単なる REST エンドポイントではなく、実際の運用ワークフローに対応しています。

ツール（v0.1）

v0.1 のツールはすべて読み取り専用です。書き込み操作は、明示的な確認を必須として、後続バージョンで追加される予定です。

ツール	説明
whoami	ヘルスチェックです。接続済みアカウントの件数（リスティング、予約、会話、オーナー明細、ユーザー）を返します。セットアップが正常に動作することを確認するため、最初に実行してください。
list_listings	アカウント内の物件を一覧表示します
get_listing	1 件のリスティングの詳細情報です。所在地、収容人数、料金、評価、チャネル URL が含まれます
list_reservations	予約を一覧表示します。到着日の範囲とステータスで絞り込むこともできます
get_reservation	1 件の予約の詳細情報です。ゲスト、日程、料金、チャネルが含まれます
list_calendar	指定した期間におけるリスティングの日ごとの空き状況を返します。「物件 X は A から B まで空いていますか？」という質問に答えます
list_conversations	未読状態と最終アクティビティを含め、ゲストとのメッセージスレッドを一覧表示します
list_unread_conversations	未読のゲストメッセージがある会話のみを表示します。「返信を待っているのは誰ですか？」という質問に答えます
get_conversation_messages	1 件の会話の全メッセージ履歴を表示します
list_owner_statements	オーナーの財務明細を一覧表示します

クイックスタート

1. Hostaway API の認証情報を取得する

Hostaway の事業者アカウントで、Settings → Hostaway API を開きます。API 認証情報を生成すると、Account ID と API Key が発行されます。

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

（または --scope local を使うと、現在のプロジェクトにのみインストールできます。）

3. または Claude Desktop に追加する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集し、次を追加します。

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

Claude Desktop を再起動します。ツールピッカーに Hostaway のツールが表示されます。

4. 試してみる

Claude に次のように尋ねてみてください。

• 「whoami を実行して、Hostaway が接続されていることを確認して。」
• 「Hostaway のリスティングを一覧表示して。」
• 「来週チェックインする予約は？」
• 「リスティング 12345 は 5 月 10 日から 17 日まで空いていますか？」
• 「未読のゲストメッセージはありますか？」
• 「[guest] との会話を表示して。」

出力例（プレースホルダーデータ）

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

# Calendar for listing 10001
8 days returned (2026-05-10 → 2026-05-17)  ·  6 available, 2 reserved, 0 blocked

| Date       | Available | Status   | Price | Min stay | Reserved | Blocked | Note |
|------------|-----------|----------|-------|----------|----------|---------|------|
| 2026-05-10 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-11 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-12 | ✗         | reserved | 220   | 2        | 1        | 0       |      |
| ...                                                                            |

設定

環境変数	必須	説明
HOSTAWAY_ACCOUNT_ID	yes	Hostaway アカウント ID（OAuth の client_id として使用）
HOSTAWAY_API_KEY	yes	Hostaway API シークレット（OAuth の client_secret として使用）

サーバーは起動時にこれらをベアラートークンに交換し、プロセスの実行中はメモリ内にキャッシュします。

ローカル開発

git clone https://github.com/prosperkartik/hostaway-mcp.git
cd hostaway-mcp
npm install
cp .env.example .env  # fill in credentials
npm run build
npm start

tsx によるホットリロード：

npm run dev

ロードマップ

• v0.1 — リスティング、予約、カレンダー、会話、財務、ヘルスチェックに対応する読み取り専用ツール 10 個
• v0.2 — タスク（list_tasks、get_task）；キャンセルポリシー；カスタムフィールドの読み取り
• v0.3 — ゲストの支払い情報の読み取り；Webhook の読み取り
• v0.4+ — 書き込み操作（ゲストメッセージの送信、カレンダーブロックの更新、タスクの作成）。明示的な confirm: true が必要です

ご要望がありますか？イシューを作成するか、ディスカッションを開始してください。

セキュリティ

• 認証情報は環境変数のみに保存され、このサーバーがディスクに書き込むことはありません
• ベアラートークンはプロセスメモリに保存され、永続ストレージには保存されません
• v0.1 はエンドツーエンドで読み取り専用です。このコードベースから Hostaway のデータを変更することはできません
• 複数の物件を運営している場合：Hostaway API は、指定された認証情報のアカウントに紐づくデータのみを返すため、アカウントをまたいだアクセスはできません

コントリビューション

イシューや PR を歓迎します。コードベースは小さく読みやすいため、src/index.ts からご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

作者

Kartik Vats（@prosperkartik）が開発しました。Kodeit の AI エンジニアです。PMS／OTA 統合と LLM ツールの本番環境での開発に 3 年間携わっています。

バケーションレンタル事業者の方、またはホスピタリティテックチームで、業務に AI を導入するサポートをご希望の場合は、kodeit.io またはメール [email protected] までお問い合わせください。