Skip to main content
MCP server CX Codex

Google Flights · kgprs — Claude Code MCP server: what it does, how to install

An MCP server that hands your agent three tools for searching Google Flights: one-way, round trip, and a whole date range.

no license updated 2026-10-29

Open on GitHub

What Google Flights does

The server exposes three tools. get_flights_on_date covers one-way trips for a single day; get_round_trip_flights takes a departure date plus a return date; find_all_flights_in_range walks date pairs across a window, optionally bounded by min_stay_days and max_stay_days. Every call accepts an adult count, a seat type, and a flag that keeps only the lowest fare.

It runs as a Python process. Start it with python server.py and it talks STDIO to your client. The scraping comes from the bundled fast_flights library, which drives Playwright browsers, so playwright install has to follow pip install -r requirements.txt. Register it in your MCP client config, such as cline_mcp_settings.json or claude_desktop_config.json, using absolute paths to the venv interpreter and to server.py.

Results come off the Google Flights page. If that page shifts or the connection is poor, answers arrive slowly or not at all, and error handling is basic. The range tool checks many date combinations, so a wide window turns into a long run.

What it helps with

  • pull one-way fares for a single day
  • compare round-trip prices on fixed departure and return dates
  • scan a window of dates and keep the cheapest pair for each
  • pass passenger count and cabin class in the same call
  • get just the lowest price instead of a full itinerary list

Example prompts for the agent

  • Find one-way flights from SVO to IST on 2025-06-12, one adult, economy.
  • Compare round trips: out 2025-06-12, back 2025-06-19, two adults.
  • Check departures between 2025-06-01 and 2025-06-30 with a stay of 5 to 10 days, cheapest only.

How to install Google Flights

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Google Flights

How do I install the Google Flights MCP server in Claude Code?

Clone the repo with git clone https://github.com/opspawn/Google-Flights-MCP-Server.git, then make a virtual environment with python -m venv .venv and activate it. Run pip install -r requirements.txt and then playwright install. Finally point your MCP client config at the absolute paths of the venv python and server.py, and start it with python server.py.

What does the Google Flights MCP server do?

It queries Google Flights for your agent: one-way fares on a date, round trips, and every option inside a date range with a limit on trip length.

Why are searches sometimes slow or empty?

The tools scrape the Google Flights page, so a change on that side or a weak connection breaks a run. Error handling is basic, so some queries need a second attempt.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Google Flights by other authors comes first.

Project sponsors

Companies that keep this analytics open