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 クライアントを選択して設定を追加します — クローンやビルドは不要です

Related MCP server: Lodgify MCP Server

セットアップ

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"]

ツールリファレンス

予約

リスティング

カレンダー

財務

会話

読み取り専用モード

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

• update_reservation_host_note

• create_calendar_block

• delete_calendar_block

• send_message

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

環境変数

クエリ例

接続後、Claude に次のように試してみてください:

• "今後の予約をすべて表示して"

• "来月のプロパティの稼働率はどうなっている？"

• "今後 90 日間の全リスティングの空き期間（gap nights）を探して"

• "先月の売上はいくらだった？"

• "未読のゲストメッセージを表示して"

• "予約 12345 の財務情報は？"

• "3 月の Airbnb 予約の支払いレポートを生成して"

コントリビューション

フィードバックやプルリクエストを歓迎します！GitHub で issue を開くか、matt@plux.com までメールをお送りください。

ライセンス

MIT