What is Google Flights Mcp Server

Google-Flights-MCP-Server is a server that provides tools to interact with Google Flights data using the fast_flights library.

Use cases

Use cases include searching for flights for a specific date, comparing round-trip flight options, and finding the cheapest flights within a date range.

How to use

To use Google-Flights-MCP-Server, clone the repository, create a virtual environment, install dependencies, and run the server using Python.

Key features

Key features include fetching one-way flights for a specific date, round-trip flights for specific dates, and finding all flights within a date range.

Where to use

Google-Flights-MCP-Server can be used in travel planning applications, flight comparison tools, and any service that requires access to flight data.

Google Flights MCP Server

This MCP server provides tools to interact with Google Flights data using the bundled fast_flights library.

Features

Provides the following MCP tools:

• get_flights_on_date: Fetches available one-way flights for a specific date between two airports.
  • Args: origin (str), destination (str), date (str, YYYY-MM-DD), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).
• get_round_trip_flights: Fetches available round-trip flights for specific departure and return dates.
  • Args: origin (str), destination (str), departure_date (str, YYYY-MM-DD), return_date (str, YYYY-MM-DD), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).
• find_all_flights_in_range: Finds available round-trip flights within a specified date range. Can optionally return only the cheapest flight found for each date pair.
  • Args: origin (str), destination (str), start_date_str (str, YYYY-MM-DD), end_date_str (str, YYYY-MM-DD), min_stay_days (int, optional), max_stay_days (int, optional), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).

Setup

1. Clone the repository:

   git clone https://github.com/opspawn/Google-Flights-MCP-Server.git
   cd Google-Flights-MCP-Server
   

2. Create a virtual environment (recommended):

   python -m venv .venv
   source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Install Playwright browsers (needed by fast_flights):

   playwright install
   

Running the Server

You can run the server directly using Python:

python server.py

The server uses STDIO transport by default.

Integrating with MCP Clients (e.g., Cline, Claude Desktop)

Add the server to your MCP client’s configuration file. Example for cline_mcp_settings.json or claude_desktop_config.json:

Important: Replace the paths in command and args with the absolute paths to your virtual environment’s Python executable and the server.py script on your system.

Notes

• This server bundles the fast_flights library (originally from https://github.com/AWeirdDev/flights) for its core flight scraping functionality. Please refer to the included LICENSE file for its terms.
• Flight scraping can sometimes be unreliable or slow depending on Google Flights changes and network conditions. The tools include basic error handling.
• The find_all_flights_in_range tool can be resource-intensive as it checks many date combinations.