@prosperkartik/hostaway-mcp

Hostaway PMS用のModel Context Protocol (MCP) サーバー — Claudeをバケーションレンタルの運用に接続します。

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

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

このサーバーの利点

理由は3つあります：

1. ツールの網羅性。 リスティング、予約、カレンダー、会話、財務、ヘルスチェックにわたる10個の読み取り専用ツールを提供しており、この分野の他のコミュニティMCPサーバーよりも広範な機能をカバーしています。

2. よりクリーンな認証UX。 HostawayのAPI設定ページで提供される2つの認証情報（アカウントID + APIキー）を使用し、OAuthトークンの交換を内部で処理します。「最初に別の場所でベアラトークンを生成する」といった手順は不要です。

3. APIの実務経験者が構築。 作者は3年以上にわたり、Hostaway / Ciirusの統合業務に携わっており、その設計思想が反映されています。ツールは単なるRESTエンドポイントではなく、実際のオペレーターのワークフローに合わせてマッピングされています。

Related MCP server: Lodgify MCP Server

ツール (v0.1)

v0.1のツールはすべて読み取り専用です。書き込み操作は今後のバージョンで追加予定であり、明示的な確認を必要とする仕様になります。

クイックスタート

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日まで空いていますか？」

• 「未読のゲストメッセージはありますか？」

• 「[ゲスト名]との会話を見せて。」

出力例 (プレースホルダーデータ)

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

設定

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

ローカル開発

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

ロードマップ

• [x] v0.1 — リスティング、予約、カレンダー、会話、財務、ヘルスチェックにわたる10個の読み取り専用ツール

• [ ] v0.2 — タスク (list_tasks, get_task)、キャンセルポリシー、カスタムフィールドの読み取り

• [ ] v0.3 — ゲスト支払いの読み取り、Webhookの読み取り

• [ ] v0.4+ — 書き込み操作（ゲストへのメッセージ送信、カレンダーブロックの更新、タスク作成）。明示的な confirm: true による保護付き

リクエストがある場合は、Issueを作成するか、ディスカッションを開始してください。

セキュリティ

• 認証情報は環境変数のみに保持され、このサーバーによってディスクに書き込まれることはありません

• ベアラトークンはプロセスメモリ内にのみ存在し、永続的なストレージには保存されません

• v0.1はエンドツーエンドで読み取り専用であり、このコードベースのいかなる機能もHostawayのデータを変更することはできません

• 複数物件を管理するオペレーターの場合、Hostaway APIは提供された認証情報のアカウントにスコープされたデータを返すため、アカウントをまたいだアクセスは不可能です

貢献

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

ライセンス

MIT — LICENSE を参照してください。

作者

Kartik Vats (@prosperkartik) が構築 — Kodeit のAIエンジニア。PMS/OTA統合およびLLMツール開発において3年間の実務経験があります。

バケーションレンタルのオペレーターやホスピタリティテックチームの方で、AIを運用に組み込むためのサポートが必要な場合は、kodeit.io またはメール prosperkartik@gmail.com までご連絡ください。