Skip to content

jackculpan/flightclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Track flight prices from Google Flights with this OpenClaw skill. Search routes, monitor prices, and get alerts when prices drop.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors