Google Flights MCP, CLI and Python Library
Quick Start Guide
This guide will help you get started with Fli quickly.
Installation
For Python Usage
pip install flights
For CLI Usage
pipx install flights
Basic Usage
Command Line Interface
- Search for one-way flights:
fli flights JFK LHR 2026-06-01
- Search for round trip flights:
fli flights JFK LHR 2026-06-01 --return 2026-06-15
- Search with filters:
fli flights JFK LHR 2026-06-01 \
--time 6-20 \ # Departure window (6 AM - 8 PM)
--airlines BA,KL \ # Airlines (British Airways, KLM)
--class BUSINESS \ # Cabin class
--stops NON_STOP # Non-stop flights only
- Search with alliance / exclusion / locale filters:
fli flights JFK LHR 2026-06-01 \
--alliance ONEWORLD \ # Limit to Oneworld members
--exclude-airlines AA \ # …but skip American
--min-layover 90 --max-layover 360 \
--currency EUR --language en-GB --country GB
- Find cheapest dates:
fli dates JFK LHR --from 2026-06-01 --to 2026-06-30
!!! warning "Experimental"
--format json is experimental.
The JSON schema is intended for agents and tools such as jq, but it may evolve in future releases.
- Return machine-readable JSON:
fli flights JFK LHR 2026-06-01 --format json
fli dates JFK LHR --from 2026-06-01 --to 2026-06-30 --format json
MCP Server (for AI Assistants)
Run the MCP server for use with Claude Desktop or other MCP clients:
# Run on STDIO (for Claude Desktop)
fli-mcp
# Run over HTTP (for web integrations)
fli-mcp-http
See the MCP Guide for detailed configuration.
Python API
- Basic One-Way Flight Search:
from fli.search import SearchFlights
from fli.models import (
FlightSearchFilters, FlightSegment,
Airport, SeatType, TripType, PassengerInfo
)
# Create flight segment
flight_segments = [
FlightSegment(
departure_airport=[[Airport.JFK, 0]],
arrival_airport=[[Airport.LAX, 0]],
travel_date="2026-06-01"
)
]
# Create filters
filters = FlightSearchFilters(
trip_type=TripType.ONE_WAY,
passenger_info=PassengerInfo(adults=1),
flight_segments=flight_segments,
seat_type=SeatType.ECONOMY
)
# Search flights
search = SearchFlights()
results = search.search(filters)
# Process results
for flight in results:
print(f"Price: ${flight.price}")
print(f"Duration: {flight.duration} minutes")
for leg in flight.legs:
print(f"Flight: {leg.airline.value} {leg.flight_number}")
- Round Trip Flight Search:
from fli.search import SearchFlights
from fli.models import (
FlightSearchFilters, FlightSegment,
Airport, TripType, PassengerInfo
)
# Create flight segments for round trip
flight_segments = [
FlightSegment(
departure_airport=[[Airport.JFK, 0]],
arrival_airport=[[Airport.LAX, 0]],
travel_date="2026-06-01"
),
FlightSegment(
departure_airport=[[Airport.LAX, 0]],
arrival_airport=[[Airport.JFK, 0]],
travel_date="2026-06-15"
)
]
# Create filters
filters = FlightSearchFilters(
trip_type=TripType.ROUND_TRIP,
passenger_info=PassengerInfo(adults=1),
flight_segments=flight_segments
)
# Search flights
search = SearchFlights()
results = search.search(filters)
# Process results - round trips return tuples of (outbound, return)
for outbound, return_flight in results:
print(f"\nOutbound Flight:")
for leg in outbound.legs:
print(f" {leg.airline.value} {leg.flight_number}")
print(f" {leg.departure_datetime} -> {leg.arrival_datetime}")
print(f"\nReturn Flight:")
for leg in return_flight.legs:
print(f" {leg.airline.value} {leg.flight_number}")
print(f" {leg.departure_datetime} -> {leg.arrival_datetime}")
print(f"\nTotal Price: ${outbound.price}")
- Date Range Search:
from fli.search import SearchDates
from fli.models import DateSearchFilters, Airport, FlightSegment, PassengerInfo
# Create filters
filters = DateSearchFilters(
passenger_info=PassengerInfo(adults=1),
flight_segments=[
FlightSegment(
departure_airport=[[Airport.JFK, 0]],
arrival_airport=[[Airport.LAX, 0]],
travel_date="2026-06-01",
)
],
from_date="2026-06-01",
to_date="2026-06-30"
)
# Search dates
search = SearchDates()
results = search.search(filters)
# Process results
for date_price in results:
print(f"Date: {date_price.date[0]}, Price: ${date_price.price}")
Running Complete Examples
All the above code snippets are available as complete, runnable examples in the
examples/python/ directory:
# Run examples with uv (recommended)
uv run python examples/python/basic_one_way_search.py
uv run python examples/python/round_trip_search.py
uv run python examples/python/date_range_search.py
# Or install dependencies first
pip install pydantic curl_cffi httpx
python examples/python/basic_one_way_search.py
Available Example Files:
basic_one_way_search.py- One-way flight search exampleround_trip_search.py- Round-trip flight search exampledate_range_search.py- Date range search examplecomplex_flight_search.py- Advanced filtering exampletime_restrictions_search.py- Time-constrained search exampledate_search_with_preferences.py- Weekend and day filtering examplecomplex_round_trip_validation.py- Complex round-trip with validationadvanced_date_search_validation.py- Advanced date search with validationprice_tracking.py- Price monitoring over timeerror_handling_with_retries.py- Robust error handling exampleresult_processing.py- Data analysis with pandas
💡 Tip: Each example is self-contained — change the airports, dates, and filters at the top of the script to fit your search.
Next Steps
- Check out the API Reference for detailed documentation
- See Advanced Examples for more complex use cases
- Read the MCP Guide for AI assistant integration
- Read about Rate Limiting and Error Handling
- Using TypeScript? See the TypeScript Quick Start