Flightclaw
Search Google Flights-backed routes, compare cabins and stops, and track prices over time from Python scripts or MCP without building a custom scraper first.
Overview
flightclaw is an agent skill most often used in Build (also Validate scope, Operate monitoring) that searches and tracks Google Flights prices via Python scripts and an MCP server with route, cabin, and alert workflows.
Install
npx skills add https://github.com/jackculpan/flightclaw --skill flightclawWhat is this skill?
- search-flights.py for route, date, return, cabin, stops, multi-airport, and date-range searches
- Filters for airline, time, duration, price, and exclude-basic style options
- Price tracking over time with alerts when fares drop
- Cheapest-date discovery for flexible travel planning
- Dual surface: agent skill scripts and MCP server for tool-using agents
- Requires Python 3.10+
- Uses pip packages flights and mcp per skill frontmatter
Adoption & trust: 938 installs on skills.sh; 57 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need repeatable flight search and price-drop monitoring in agent or terminal workflows without hand-rolling Google Flights access each time.
Who is it for?
Developers on Python 3.10+ who want flight search, multi-airport/date-range queries, and price tracking from the terminal or through MCP tools.
Skip if: Builders who cannot run Python or pip, need guaranteed booking/compliance with airline TOS in production apps without their own review, or want a no-network offline fare database.
When should I use this skill?
Track flight prices using Google Flights data—search routes, find cheapest dates, filter results, track over time, or get drop alerts; also when exposing the same via MCP.
What do I get? / Deliverables
You get scriptable search results, cheapest-date views, and ongoing route tracking suitable for CLI use or MCP-connected agents after setup.sh installs dependencies.
- Terminal flight search output for specified routes, dates, and filters
- Tracked route history and price-drop alert workflow when configured
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
The canonical shelf is Build integrations because the skill is implemented as Python CLI scripts plus an optional MCP server wiring external flight data into agent workflows. Integrations fits the pip-installed flights and mcp packages, setup.sh, and script/MCP entry points rather than frontend UI or pure planning docs.
Where it fits
Estimate conference travel cost by searching LHR to JFK across a July date range before committing to event dates.
Wire the MCP server so your coding agent can call flight search tools while drafting a travel-helper side project.
Keep a tracked route and react when the skill’s alert path reports a fare drop for a recurring customer visit.
How it compares
Python script plus optional MCP integration—not a hosted SaaS fare API product with SLAs.
Common Questions / FAQ
Who is flightclaw for?
Solo builders and small teams who use Claude Code, Cursor, or Codex-style agents and want Google Flights-oriented search and tracking from Python or MCP.
When should I use flightclaw?
Use it while validating travel budgets for a launch trip, building agent tools that quote routes, or operating ongoing price watches on routes you care about; run setup.sh or npx skills add before scripting searches.
Is flightclaw safe to install?
It runs local Python with network access to flight data sources; review the Security Audits panel on this page, inspect jackculpan/flightclaw, and treat API/network behavior as something you must verify before production use.
SKILL.md
READMESKILL.md - Flightclaw
# flightclaw Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop. ## Install ```bash npx skills add jackculpan/flightclaw ``` Or manually: ```bash bash skills/flightclaw/setup.sh ``` ## Scripts ### Search Flights Find flights for a specific route and date. Supports multiple airports and date ranges. ```bash python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08 python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10 python skills/flightclaw/scripts/search-flights.py DTW MCO 2026-10-09 --return-date 2026-10-15 --exclude-basic # Multiple airports (searches all combinations) python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 # Date range (searches each day) python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05 # Both python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 ``` Arguments: - `origin` - IATA airport code(s), comma-separated (e.g. LHR or LHR,MAN) - `destination` - IATA airport code(s), comma-separated (e.g. JFK or JFK,EWR) - `date` - Departure date (YYYY-MM-DD) - `--date-to` - End of date range (YYYY-MM-DD). Searches each day from date to date-to inclusive. - `--return-date` - Return date for round trips (YYYY-MM-DD) - `--cabin` - ECONOMY (default), PREMIUM_ECONOMY, BUSINESS, FIRST - `--stops` - ANY (default), NON_STOP, ONE_STOP, TWO_STOPS - `--results` - Number of results (default: 5) - `--exclude-basic` - Exclude Basic Economy fares; show Standard (Main Cabin) prices only ### Track a Flight Add a route to the price tracking list and record the current price. Supports multiple airports and date ranges (creates a separate tracking entry for each combination). ```bash python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400 python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS python skills/flightclaw/scripts/track-flight.py DTW MCO 2026-10-09 --return-date 2026-10-15 --exclude-basic --target-price 500 # Track multiple airports and dates python skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400 ``` Arguments: - Same as search-flights, plus: - `--target-price` - Alert when price drops below this amount - `--exclude-basic` - Exclude Basic Economy fares (persisted per tracked route) ### Check Prices Check all tracked flights for price changes. Designed to run on a schedule (cron). ```bash python skills/flightclaw/scripts/check-prices.py python skills/flightclaw/scripts/check-prices.py --threshold 5 ``` Arguments: - `--threshold` - Percentage drop to trigger alert (default: 10) Output: Reports price changes for tracked flights. Highlights drops and alerts when target prices are reached. ### List Tracked Flights Show all flights being tracked with current vs original prices. ```bash python skills/flightclaw/scripts/list-tracked.py ``` ## MCP Server FlightClaw also runs as an MCP server with extended search capabilities: ```bash pip install flights "mcp[cli]" claude mcp add flightclaw -- python3 server.py ``` MCP tools: `search_flights`, `search_dates`, `track_flight`, `check_prices`, `list_tracked`, `remove_tracked` Additional MCP filters: passenger