hostaway-mcp

Hostaway向けの読み取り専用、ホスピタリティ特化型MCPサーバー。

このリポジトリはオペレーター製品のみを対象としています：ローカル/npm stdio、6つの読み取り専用ツール、Cloudflare Workerなし、Seascape予約インターフェースなし。

V1の目標

毎回生のAPI呼び出しを手動で記述することなく、CodexやClaudeを実際のHostawayワークフローで役立つようにします。

V1は意図的に範囲を絞っています：

• 読み取り専用のみ

• 生のエンドポイントの網羅ではなく、ホスピタリティにネイティブなツール

• 会話コンテキスト、予約検索、リスティング検索に最適化

Related MCP server: guesty-mcp-server

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経由で起動します。

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

hostaway-mcp@0.2.0

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

Claude Desktop (macOS)

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

preferences などのトップレベルキーが既にある場合は、それを保持したまま mcpServers を追加してください：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

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

Codex

~/.codex/config.toml を編集し、以下を追加します：

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[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"
  }
}

環境変数

V1の対象外

• ゲストへのメッセージ送信

• 予約やリスティングの変更

• Cloudflare Workerトランスポート

• Seascape予約/配信フロー

• Webhookの取り込み

• バックグラウンド同期パイプライン

• ダッシュボードやオーナー向けレポート

• 汎用的なREST-to-MCPプロキシの網羅

ソース設計

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