Fli is a Python library and MCP server that provides programmatic access to Google Flights data through direct API integration. Unlike traditional approaches that rely on web scraping, it reverse-engineers Google's internal API to deliver faster, more reliable flight search results without browser automation. Key capabilities: - Search flights between airport IATA codes with specific departure dates or flexible date ranges to identify cheapest travel windows - Filter results by cabin class (Economy, Premium Economy, Business, First), maximum layovers, departure time windows, and preferred airlines - Sort results by price, total duration, departure time, or arrival time - Support for one-way and round-trip searches with passenger count specification - Available as pip-installable CLI tools (`fli-mcp` for stdio, `fli-mcp-http` for streamable HTTP)

🛫 Fli - Flight Search MCP Server and Library

A powerful Python library that provides programmatic access to Google Flights data with an elegant CLI interface. Search flights, find the best deals, and filter results with ease.

> 🚀 What makes fli special? > Unlike other flight search libraries that rely on web scraping, Fli directly interacts with Google Flights' API > through reverse engineering. > This means: > > * Fast: Direct API access means faster, more reliable results > * Zero Scraping: No HTML parsing, no browser automation, just pure API interaction > * Reliable: Less prone to breaking from UI changes > * Modular: Extensible architecture for easy customization and integration

MCP Server

pipx install flights
Run the MCP server on STDIO
fli-mcp
Run the MCP server over HTTP (streamable)
fli-mcp-http  # serves at http://127.0.0.1:8000/mcp/

Connecting to Claude Desktop

{
  "mcpServers": {
    "fli": {
      "command": "/Users//.local/bin/fli-mcp"
    }
  }
}

> Note: Replace ` with your actual username. > You can also find the path to the MCP server by running which fli-mcp in your terminal.

MCP Tools Available

The MCP server provides two main tools:

| Tool | Description | |----------------------|-------------------------------------------------------------| | search_flights | Search for flights on a specific date with detailed filters | | search_dates | Find the cheapest travel dates across a flexible date range |

#### search_flights Parameters

| Parameter | Type | Description | |--------------------|--------|-----------------------------------------------------| | origin | string | Departure airport IATA code (e.g., 'JFK') | | destination | string | Arrival airport IATA code (e.g., 'LHR') | | departure_date | string | Travel date in YYYY-MM-DD format | | return_date | string | Return date for round trips (optional) | | cabin_class | string | ECONOMY, PREMIUM_ECONOMY, BUSINESS, or FIRST | | max_stops | string | ANY, NON_STOP, ONE_STOP, or TWO_PLUS_STOPS | | departure_window | string | Time window in 'HH-HH' format (e.g., '6-20') | | airlines | list | Filter by airline codes (e.g., ['BA', 'AA']) | | sort_by | string | CHEAPEST, DURATION, DEPARTURE_TIME, or ARRIVAL_TIME | | passengers | int | Number of adult passengers |

#### search_dates Parameters

| Parameter | Type | Description | |--------------------|--------|----------------------------------------------| | origin | string | Departure airport IATA code (e.g., 'JFK') | | destination | string | Arrival airport IATA code (e.g., 'LHR') | | start_date | string | Start of date range in YYYY-MM-DD format | | end_date | string | End of date range in YYYY-MM-DD format | | trip_duration | int | Trip duration in days (for round-trips) | | is_round_trip | bool | Whether to search for round-trip flights | | cabin_class | string | ECONOMY, PREMIUM_ECONOMY, BUSINESS, or FIRST | | max_stops | string | ANY, NON_STOP, ONE_STOP, or TWO_PLUS_STOPS | | departure_window | string | Time window in 'HH-HH' format (e.g., '6-20') | | airlines | list | Filter by airline codes (e.g., ['BA', 'AA']) | | sort_by_price | bool | Sort results by price (lowest first) | | passengers | int | Number of adult passengers |

Quick Start

pip install flights

# Install using pipx (recommended for CLI)
pipx install flights
Get started with CLI
fli --help

Features

``bash

Basic flight search

Advanced search with filters