hostaway

hostaway-mcp

Claude Desktop、Claude Code、Cursor などの AI アシスタントを、Hostaway の物件管理 API に接続するオープンソースの Model Context Protocol (MCP) サーバーです。自然な言葉で予約、リスティング、カレンダー、財務情報、ゲストとの会話を照会できます。

クイックスタート

1. Hostaway ダッシュボードの Settings > API から Account ID と Client Secret を取得します
2. Node.js 18+ がインストールされていることを確認します
3. 以下から AI クライアントを選び、設定を追加します。クローンやビルドは不要です

セットアップ

Claude Desktop（Mac および Windows）

Claude Desktop の設定ファイルを開きます。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下を追加します（ほかのサーバーを設定済みの場合は、既存の mcpServers に統合してください）。

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Claude Desktop を再起動すれば、準備完了です。

Claude Code

オプション 1 — CLI コマンド（最も簡単）：

claude mcp add hostaway \
  -e HOSTAWAY_ACCOUNT_ID=YOUR_ACCOUNT_ID \
  -e HOSTAWAY_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -- npx -y @matt-long-plux/hostaway-mcp

オプション 2 — プロジェクトのルートに .mcp.json を配置（チームメイトとの共有に便利です）：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Cursor

プロジェクトの .cursor/mcp.json に同じ設定を追加するか、Cursor Settings > MCP Servers > Add Server に移動して貼り付けます。

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

更新

以前のバージョンを npx 経由でインストールした場合、システムにキャッシュされたコピーが残っていることがあります。最新リリースに更新するには、次を実行します。

npx clear-npx-cache

その後、AI クライアント（Claude Desktop、Cursor など）を再起動します。次回の起動時に、最新バージョンが自動的に取得されます。

また、設定で @latest を指定すると、再起動のたびに常に最新バージョンを取得できます。

"args": ["-y", "@matt-long-plux/hostaway-mcp@latest"]

ツール一覧

予約

ツール	説明	主なパラメーター
list_reservations	フィルターを指定して予約を一覧表示します	listingMapId、dateFrom、dateTo、status、channelId、limit
get_reservation	予約の詳細をすべて取得します	reservationId（必須）
update_reservation_host_note	内部向けのホストメモを更新します	reservationId、hostNote（必須）
list_reservations_by_property	現在および今後の予約を物件ごとにグループ化して表示します	なし

リスティング

ツール	説明	主なパラメーター
list_listings	メタデータを含む、すべての有効なリスティングを表示します	includeArchived
get_listing	リスティングの詳細をすべて取得します	listingId（必須）
get_listing_custom_fields	カスタムフィールドの値を名前と値のマップとして取得します	listingId（必須）

カレンダー

ツール	説明	主なパラメーター
get_calendar	空室状況と料金のカレンダーを取得します	listingId、startDate、endDate（すべて必須）
get_gap_nights	予約間にある、予約されていない短い空き期間を検索します	listingId（必須）、startDate、endDate、maxGapLength
create_calendar_block	カレンダーの日付をブロックします	listingId、startDate、endDate（必須）、note
delete_calendar_block	カレンダーのブロックを削除します	listingId、calendarBlockId（必須）

財務情報

ツール	説明	主なパラメーター
get_reservation_financials	予約の財務内訳を取得します	reservationId（必須）
get_revenue_summary	リスティング全体の収益を集計して取得します	dateFrom、dateTo（必須）、listingId
get_payout_report	照合用の支払レポートを取得します	dateFrom、dateTo（必須）、channelId

会話

ツール	説明	主なパラメーター
list_conversations	最近のゲストとの会話	listingId、limit、unreadOnly
get_conversation	メッセージスレッド全体	conversationId（必須）
send_message	ゲストにメッセージを送信	conversationId、message（必須）

読み取り専用モード

HOSTAWAY_READ_ONLY=true を設定すると、書き込み／変更を行うすべてのツールが無効になります。有効にすると、以下のツールは実行されず、エラーを返します。

• update_reservation_host_note
• create_calendar_block
• delete_calendar_block
• send_message

共有アカウントを使用する場合や、誤った変更を防ぎたい場合に便利です。

環境変数

変数	必須	説明
HOSTAWAY_ACCOUNT_ID	はい	Hostaway アカウント ID（整数）
HOSTAWAY_CLIENT_SECRET	はい	Hostaway API クライアントシークレット
HOSTAWAY_READ_ONLY	いいえ	true に設定すると書き込み操作を無効化
HOSTAWAY_CACHE_TTL	いいえ	トークンキャッシュの TTL（秒単位、デフォルト：240）

クエリの例

接続したら、Claude に次のように尋ねてみてください。

• 「今後の予約をすべて表示して」
• 「来月の宿泊施設の稼働率はどのくらい？」
• 「今後 90 日間のすべてのリスティングから、予約の空き日を探して」
• 「先月の収益はいくら？」
• 「未読のゲストメッセージを表示して」
• 「予約 12345 の財務情報は？」
• 「3 月の Airbnb 予約の支払いレポートを作成して」

コントリビューション

フィードバックやプルリクエストを歓迎します。GitHub で issue を作成するか、[email protected] までメールでご連絡ください。

ライセンス

MIT