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, defaultFalse).
- Args:
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, defaultFalse).
- Args:
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, defaultFalse).
- Args:
Setup
- Clone the repository:
git clone https://github.com/opspawn/Google-Flights-MCP-Server.git cd Google-Flights-MCP-Server
- Create a virtual environment (recommended):
python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
- Install dependencies:
pip install -r requirements.txt
- 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:
{
"mcpServers": {
"google-flights": {
"command": "/path/to/your/.venv/bin/python", // Use absolute path to venv python
"args": [
"/absolute/path/to/flight_mcp_server/server.py" // Use absolute path to server script
],
"env": {},
"disabled": false,
"autoApprove": []
}
// ... other servers
}
}
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_flightslibrary (originally from https://github.com/AWeirdDev/flights) for its core flight scraping functionality. Please refer to the includedLICENSEfile 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_rangetool can be resource-intensive as it checks many date combinations.
Metadata
Release files for iflow-mcp_opspawn-google-flights-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_opspawn_google_flights_mcp_server-0.1.0.tar.gz | 50.8 kB | Without provenance | Details for iflow_mcp_opspawn_google_flights_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_opspawn_google_flights_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_opspawn_google_flights_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 106.7 kB
Release files / iflow_mcp_opspawn_google_flights_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_opspawn_google_flights_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 50.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
387e90ca7e5044c15ee674f364b732a9a0f1f05ef822133b1e22fb3754f5e7bb
|
|
BLAKE2b-256 checksum How to use checksums |
f07ead191c12f93ef9a3d38c21feaaa307e2dbb28b145e1a68511212cd141c5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_opspawn_google_flights_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_opspawn_google_flights_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 55.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e6f66157c564b5fe48d1ba57e83fd6ec376de0f7d1d188cd1d1dd1fab55fab0a
|
|
BLAKE2b-256 checksum How to use checksums |
1d072b6a9ae7e0ebc904561825ae8bc2ecc6769d2ec8666e81a47ea5f43974ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_opspawn-google-flights-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.