Google Flights MCP, CLI and Python Library
Search API Reference
Flight Search
The main search functionality for finding specific flights.
SearchFlights
::: fli.search.flights.SearchFlights
FlightSearchFilters
A simplified interface for flight search parameters.
::: fli.models.google_flights.FlightSearchFilters
Date Search
Search functionality for finding the cheapest dates to fly.
SearchDates
::: fli.search.dates.SearchDates
DatePrice
::: fli.search.dates.DatePrice
Examples
Basic Flight Search
from fli.search import SearchFlights
from fli.models import Airport, SeatType, FlightSearchFilters, FlightSegment, PassengerInfo
# Create filters
filters = FlightSearchFilters(
passenger_info=PassengerInfo(adults=1),
flight_segments=[
FlightSegment(
departure_airport=[[Airport.JFK, 0]],
arrival_airport=[[Airport.LAX, 0]],
travel_date="2026-06-01",
)
],
seat_type=SeatType.ECONOMY
)
# Search flights
search = SearchFlights()
results = search.search(filters)
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)
Running These Examples
You can find complete, runnable versions of these examples in the examples/python/ directory:
# Run with uv (recommended)
uv run python examples/python/basic_one_way_search.py
uv run python examples/python/date_range_search.py
# Or install dependencies and run directly
pip install pydantic curl_cffi httpx
python examples/python/basic_one_way_search.py
For more advanced examples, see:
examples/python/complex_flight_search.py- Advanced filteringexamples/python/result_processing.py- Data analysisexamples/python/error_handling_with_retries.py- Robust error handling
HTTP Client
The underlying HTTP client used for API requests.
Client
::: fli.search.client.Client