flightclaw

Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.

MCP Server

FlightClaw runs as a local MCP server, giving any MCP-compatible client (Claude Code, Claude Desktop, etc.) access to flight search and tracking tools.

Setup

# Install dependencies
pip install flights "mcp[cli]"

# Add to Claude Code
claude mcp add flightclaw -- python3 /path/to/flightclaw/server.py

Or in Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "flightclaw": {
      "command": "python3",
      "args": ["/path/to/flightclaw/server.py"]
    }
  }
}

Tools

Tool	Description
search_flights	Search Google Flights for prices on a route
search_dates	Find cheapest dates to fly across a date range (calendar view)
track_flight	Add a route to price tracking with optional target price
check_prices	Check all tracked flights for price changes and alerts
list_tracked	List all tracked flights with price history
remove_tracked	Remove a route from tracking

Search filters

All search tools support:

• Passengers - adults, children, infants (in seat or on lap)
• Airlines - filter to specific carriers (e.g. BA,AA,DL)
• Price limit - max price in USD
• Duration - max total flight time in minutes
• Times - earliest/latest departure and arrival hours
• Layovers - max layover duration in minutes
• Sorting - by BEST, CHEAPEST, DEPARTURE, ARRIVAL, or DURATION
• Multi-airport - comma-separated codes (e.g. LHR,MAN)
• Date ranges - date_to for searching each day in a range

Example prompts

• "Search flights from LHR to JFK on 2025-08-01 in business class"
• "Find nonstop BA or VS flights LHR to JFK departing after 8am"
• "What are the cheapest dates to fly LHR to JFK in July?"
• "Search for 2 adults and 1 child, LHR to JFK, under $500"
• "Track LHR to SFO on 2025-07-01 with a target price of $400"
• "Check my tracked flights for price drops"

CLI Scripts

The original CLI scripts are still available in scripts/:

# Search flights
python scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS

# Multiple airports and date ranges
python scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-05

# Track a route
python scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400

# Check for price drops (good for cron)
python scripts/check-prices.py --threshold 5

# List tracked flights
python scripts/list-tracked.py

How it works

• Queries Google Flights via the fli library
• Prices returned in user's local currency (auto-detected from IP)
• Price history persists in data/tracked.json
• Supports one-way and round trips, all cabin classes (economy to first)
• Filter by airline, price, duration, departure/arrival times, layover duration
• Multi-airport and date-range searches expand into all combinations
• Date search finds the cheapest day to fly across a range

Install (OpenClaw)

npx skills add jackculpan/flightclaw