The Google Flights MCP Server integrates Google Flights data into AI workflows for intelligent flight search, price comparison, and automated travel planning.
Flight Search:
Search one-way or round-trip flights for specific dates, with control over passenger counts (adults, children, infants), seat class (economy, premium economy, business, first), and maximum stops
Search round-trips across a date range to compare all combinations, with stay duration filters and pagination
Search direct/non-stop flights for one-way or round-trip itineraries
Search multi-city/multi-leg itineraries (experimental; may fall back to a Google Flights URL)
Filter by specific airline codes or alliances (STAR_ALLIANCE, SKYTEAM, ONEWORLD)
Travel Planning:
Calculate suggested departure/return dates relative to today (e.g., "departing in 45 days for 10 days")
Generate shareable Google Flights search URLs for any itinerary
Access 10 built-in prompts for common scenarios: weekend getaway, business trip, family vacation, budget backpacking, loyalty program optimization, and more
Data & Airport Info:
Browse all available airports or get details for a specific airport (
airports://allorairports://{code})Default data source is free (fast-flights); optionally use a SerpAPI key for richer data including flight numbers, layovers, carbon emissions, and multi-seller booking options
Deployment:
Install via PyPI, run from source, or deploy remotely as an SSE server (e.g., on Hugging Face Spaces); compatible with Claude Desktop and other MCP clients
Enables flight search and travel planning through Google Flights, including price comparisons, flexible date searches, multi-city itineraries, and filtering by airlines, stops, and cabin class.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Flights MCP Serverfind the cheapest round-trip flights from LAX to Tokyo for two adults in economy next month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
title: Google Flights MCP emoji: ✈️ colorFrom: blue colorTo: indigo sdk: docker pinned: false
Google Flights MCP Server
A Model Context Protocol (MCP) server for intelligent flight search and travel planning
Overview
Integrates Google Flights data directly into your AI workflow with natural language searches, intelligent price comparisons, and automated travel planning.
Data Sources:
fast-flights (Primary): Free, no API key required
SerpAPI (Fallback): Richer data including flight numbers, layovers, carbon emissions, and multi-seller booking options — used when
SERPAPI_API_KEYis set (250 free searches/month)
Tools
Tool | Description |
| One-way flights for a specific date |
| Round-trip flights with fixed dates (supports |
| Search all round-trip combinations within a date range |
| Filter flights by airline codes or alliance (STAR_ALLIANCE, SKYTEAM, ONEWORLD) |
| Calculate travel dates relative to today |
| Generate a shareable Google Flights search link |
Resources
airports://all— Browse available airportsairports://{code}— Get info for a specific airport (e.g.airports://LAX)
Prompts
10 built-in travel planning prompts: find_best_deal, weekend_getaway, last_minute_travel, business_trip, family_vacation, budget_backpacker, loyalty_program_optimizer, holiday_peak_travel, long_haul_international, stopover_explorer.
Quick Start
Option 1: Install from PyPI
uvx mcp-server-google-flightsOption 2: Run from source
git clone https://github.com/HaroldLeo/google-flights-mcp.git
cd google-flights-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .Configuration
Claude Desktop
{
"mcpServers": {
"google-flights": {
"command": "uvx",
"args": ["mcp-server-google-flights"],
"env": {
"SERPAPI_API_KEY": "your_serpapi_key_here"
}
}
}
}From source
{
"mcpServers": {
"google-flights": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/google-flights-mcp/src/mcp_server_google_flights/server.py"],
"env": {
"SERPAPI_API_KEY": "your_serpapi_key_here"
}
}
}
}Get a free SerpAPI key: serpapi.com/users/sign_up (250 free searches/month)
Remote Deployment (Hugging Face Spaces)
This server supports remote deployment as an SSE MCP server.
Deploy to HF Spaces
Create a new Space at huggingface.co/new-space with Docker SDK
Push this repository to the Space
(Optional) Add
SERPAPI_API_KEYas a Space secret
The Dockerfile and transport switching are already configured — set MCP_TRANSPORT=sse (done automatically in the Dockerfile) to run in SSE mode.
Connect to a deployed Space
{
"mcpServers": {
"google-flights": {
"url": "https://YOUR-USERNAME-google-flights-mcp.hf.space/sse"
}
}
}Environment Variables
Variable | Description |
| SerpAPI key for richer flight data (optional) |
|
|
| Host for SSE mode (default: |
| Port for SSE mode (default: |
Troubleshooting
No flights found: Try a different date or route. Google Flights rate-limits scraping — SerpAPI fallback is more reliable.
401 error: Update to the latest version. Older versions used a remote Playwright service that now requires auth.
Slow searches: search_round_trips_in_date_range is limited to 30 date combinations to avoid rate limiting. Narrow your date range or use min_stay_days/max_stay_days.
License
MIT — see LICENSE
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.