npm package: @striderlabs/mcp-hyatt
Description: MCP server connector for Hyatt Hotels using Playwright browser automation
Author: Strider Labs
Latest version: 1.0.0

# @striderlabs/mcp-hyatt

MCP (Model Context Protocol) server for Hyatt Hotels — search properties, manage reservations, and interact with World of Hyatt rewards using Playwright browser automation.

## Installation

```bash
npm install -g @striderlabs/mcp-hyatt
npx playwright install chromium
```

## Usage with Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hyatt": {
      "command": "striderlabs-mcp-hyatt"
    }
  }
}
```

## Usage with MCP CLI

```bash
mcp run striderlabs-mcp-hyatt
```

## Tools

### `hyatt_login`
Authenticate with your Hyatt account. Required before using account-specific tools.

| Parameter | Type   | Required | Description              |
|-----------|--------|----------|--------------------------|
| email     | string | Yes      | Hyatt account email      |
| password  | string | Yes      | Hyatt account password   |

---

### `hyatt_search_hotels`
Search for available Hyatt hotels by location and dates.

| Parameter  | Type   | Required | Description                                      |
|------------|--------|----------|--------------------------------------------------|
| location   | string | Yes      | City, airport code, or address                   |
| check_in   | string | Yes      | Check-in date (YYYY-MM-DD)                        |
| check_out  | string | Yes      | Check-out date (YYYY-MM-DD)                       |
| guests     | number | No       | Number of guests (default: 1)                    |
| brand      | string | No       | Filter by brand (e.g. "Park Hyatt", "Andaz")     |

**Supported brands:** Park Hyatt, Grand Hyatt, Hyatt Regency, Hyatt Place, Hyatt House, Alila, Andaz, Thompson Hotels, Caption by Hyatt, Unbound Collection, Joie de Vivre, Destination by Hyatt, Hyatt Ziva, Hyatt Zilara, Miraval.

---

### `hyatt_get_hotel_details`
Get detailed information about a specific Hyatt property.

| Parameter | Type   | Required | Description          |
|-----------|--------|----------|----------------------|
| hotel_id  | string | Yes      | Hotel ID from search |

---

### `hyatt_get_room_rates`
Get available room types and current rates for specific dates.

| Parameter | Type   | Required | Description                    |
|-----------|--------|----------|--------------------------------|
| hotel_id  | string | Yes      | Hotel ID                       |
| check_in  | string | Yes      | Check-in date (YYYY-MM-DD)      |
| check_out | string | Yes      | Check-out date (YYYY-MM-DD)     |
| guests    | number | No       | Number of guests (default: 1)  |

---

### `hyatt_book_room`
Book a hotel room. Requires prior login.

| Parameter  | Type   | Required | Description                            |
|------------|--------|----------|----------------------------------------|
| hotel_id   | string | Yes      | Hotel ID                               |
| room_type  | string | Yes      | Room type name from `hyatt_get_room_rates` |
| check_in   | string | Yes      | Check-in date (YYYY-MM-DD)              |
| check_out  | string | Yes      | Check-out date (YYYY-MM-DD)             |
| guest_info | object | Yes      | Guest details (see below)              |

**guest_info fields:**
- `firstName` (string, required)
- `lastName` (string, required)
- `email` (string, required)
- `phone` (string, optional)
- `specialRequests` (string, optional)

---

### `hyatt_get_reservations`
List all reservations on the logged-in account (upcoming and past).

No parameters required.

---

### `hyatt_get_reservation_details`
Get full details for a specific reservation.

| Parameter           | Type   | Required | Description             |
|---------------------|--------|----------|-------------------------|
| confirmation_number | string | Yes      | Reservation confirmation number |

---

### `hyatt_cancel_reservation`
Cancel a reservation. Requires login.

| Parameter           | Type   | Required | Description             |
|---------------------|--------|----------|-------------------------|
| confirmation_number | string | Yes      | Confirmation number to cancel |

---

### `hyatt_modify_reservation`
Modify an existing reservation. Requires login.

| Parameter           | Type   | Required | Description                     |
|---------------------|--------|----------|---------------------------------|
| confirmation_number | string | Yes      | Confirmation number to modify   |
| changes             | object | Yes      | Fields to change (see below)    |

**changes fields (all optional):**
- `checkIn` (string) — new check-in date
- `checkOut` (string) — new check-out date
- `guests` (number) — updated guest count
- `roomType` (string) — new room type
- `specialRequests` (string) — updated special requests

---

### `hyatt_get_world_of_hyatt_balance`
Get World of Hyatt points balance, tier status, and qualifying nights.

No parameters required. Requires login.

---

### `hyatt_get_rewards_history`
Get the full points earning and redemption transaction history.

No parameters required. Requires login.

---

### `hyatt_redeem_points`
Check award availability and view points rates for a hotel.

| Parameter | Type   | Required | Description                    |
|-----------|--------|----------|--------------------------------|
| hotel_id  | string | Yes      | Hotel ID                       |
| check_in  | string | Yes      | Check-in date (YYYY-MM-DD)      |
| check_out | string | Yes      | Check-out date (YYYY-MM-DD)     |
| guests    | number | No       | Number of guests (default: 1)  |

## How It Works

This package uses [Playwright](https://playwright.dev/) to automate a headless Chromium browser that navigates hyatt.com on your behalf. No official API keys are required — it authenticates using your Hyatt account credentials.

## Requirements

- Node.js 18+
- Chromium (installed via `npx playwright install chromium`)

## License

MIT