io.github.markswendsen-code/southwest

@striderlabs/mcp-southwest

MCP server for Southwest Airlines — search flights, manage bookings, check in, and manage your Rapid Rewards account via browser automation.

Features

• Search flights with real-time pricing across all fare classes
• Compare fares: Wanna Get Away, Wanna Get Away+, Anytime, Business Select
• Book flights with dollars or Rapid Rewards points
• Manage reservations: change, cancel, get details
• No change fees — Southwest never charges them
• Check in online (opens exactly 24 hours before departure)
• Get boarding passes with group/position (A/B/C)
• Early Bird Check-In — auto check-in 36 hours before departure
• Rapid Rewards — check points balance, tier status, Companion Pass progress

Prerequisites

• Node.js 18+
• Playwright browsers: npx playwright install chromium

Installation

npm install -g @striderlabs/mcp-southwest
# or
npx @striderlabs/mcp-southwest

Setup

Environment Variables

Create a .env file or set these in your environment:

# Required for account-based tools (check-in, Rapid Rewards, points booking)
SW_USERNAME=your_rapid_rewards_number_or_email
SW_PASSWORD=your_password

# Optional
SW_HEADLESS=true   # Set to "false" to see the browser (useful for debugging)

Claude Desktop Configuration

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

{
  "mcpServers": {
    "southwest": {
      "command": "npx",
      "args": ["@striderlabs/mcp-southwest"],
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "southwest": {
      "command": "mcp-southwest",
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

Available Tools

search_flights

Search for available Southwest flights.

{
  "originAirport": "DAL",
  "destinationAirport": "LAX",
  "departureDate": "2024-06-15",
  "passengers": 2,
  "tripType": "oneway",
  "fareType": "USD"
}

get_flight_details

Get status and details for a specific flight.

{
  "flightNumber": "WN1234",
  "flightDate": "2024-06-15",
  "originAirport": "DAL",
  "destinationAirport": "LAX"
}

select_flight

Select a flight from search results to proceed with booking.

{
  "flightIndex": 0,
  "fareType": "wanna-get-away"
}

get_fares

Compare fare classes with pricing and benefits.

{
  "originAirport": "HOU",
  "destinationAirport": "MCO",
  "departureDate": "2024-07-04",
  "fareType": "USD"
}

add_early_bird

Add Early Bird Check-In to an existing booking (~$15–25/person/flight).

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

checkout

Complete a booking with passenger and payment details.

{
  "firstName": "Jane",
  "lastName": "Smith",
  "dateOfBirth": "01/15/1990",
  "gender": "F",
  "email": "jane@example.com",
  "phone": "5551234567",
  "cardNumber": "4111111111111111",
  "cardExpiration": "12/26",
  "cardCvv": "123",
  "cardZip": "75201",
  "cardName": "Jane Smith",
  "addEarlyBird": false
}

get_reservation

Look up a booking by confirmation number.

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

change_flight

Modify an existing booking (no change fees!).

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "newDepartureDate": "2024-06-20"
}

cancel_flight

Cancel a reservation. Use confirm: true to actually cancel.

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "confirm": true
}

check_in

Check in online (available 24 hours before departure).

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

get_boarding_pass

Retrieve boarding pass with group and position number.

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "savePath": "~/boarding-pass.pdf"
}

get_rapid_rewards

Check Rapid Rewards points, tier status, and Companion Pass progress.

{}

(Uses SW_USERNAME/SW_PASSWORD env vars)

book_with_points

Search for flights and book using Rapid Rewards points.

{
  "originAirport": "DAL",
  "destinationAirport": "DEN",
  "departureDate": "2024-08-10",
  "passengers": 1
}

Southwest Airlines Fare Classes

Southwest Boarding System

Southwest uses open seating — no assigned seats. Passengers board in groups:

• Group A (A1–A60): Early Bird / Business Select / Anytime priority
• Group B (B1–B60): General boarding
• Group C (C1–C60): Last to board

Check-in order determines boarding position. Check in exactly at the 24-hour mark for the best position.

Session Persistence

Login sessions are saved to ~/.config/mcp-southwest/session.json to avoid re-authenticating on every run.

Development

git clone https://github.com/markswendsen-code/mcp-southwest
cd mcp-southwest
npm install
npx playwright install chromium
npm run build
npm start

For development with hot reload:

npm run dev

To see the browser during automation (useful for debugging):

SW_HEADLESS=false npm run dev

License

MIT © Strider Labs