Skip to main content
Glama
HaroldLeo

Google Flights MCP Server

by HaroldLeo

search_round_trips_in_date_range

Find round-trip flights between airports within flexible date ranges, with options to filter by stay duration and return cheapest options.

Instructions

Finds available round-trip flights within a specified date range. Can optionally return only the cheapest flight found for each date pair. ⚠️ RATE LIMIT WARNING: This function makes multiple Google Flights scraping requests. Each date pair combination = 1 request. The function is LIMITED to a MAXIMUM of 30 requests to prevent rate limiting and IP blocking. Example request counts: - 7 day range with 5-7 day stays: ~10-15 requests (Safe) - 14 day range with no limits: ~105 requests (WILL BE REJECTED) - 30 day range: ~465 requests (WILL BE REJECTED) 💡 TIP: Use min_stay_days and max_stay_days to reduce combinations. Set return_cheapest_only=true for faster results. Args: origin: Origin airport code (e.g., "DEN"). destination: Destination airport code (e.g., "LAX"). start_date_str: Start date of the search range (YYYY-MM-DD format). end_date_str: End date of the search range (YYYY-MM-DD format). min_stay_days: Minimum number of days for the stay (optional). max_stay_days: Maximum number of days for the stay (optional). adults: Number of adult passengers (default: 1). seat_type: Fare class (e.g., "economy", "business", default: "economy"). max_stops: Maximum number of stops (0=direct, 1=one stop, 2=two stops, default: 2). return_cheapest_only: If True, returns only the cheapest flight for each date pair (default: False). max_results: Maximum number of results to return (default: 10). Set to 0 or -1 for unlimited. offset: Number of results to skip (for pagination, default: 0). compact_mode: If True, return only essential fields (saves ~40% tokens, default: False). limit: Maximum number of date pairs to process (for pagination, default: 20). Example Args: {"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5} {"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5, "return_cheapest_only": true}

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
originYes
destinationYes
start_date_strYes
end_date_strYes
min_stay_daysNo
max_stay_daysNo
adultsNo
seat_typeNoeconomy
max_stopsNo
return_cheapest_onlyNo
max_resultsNo
offsetNo
limitNo

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/HaroldLeo/google-flights-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server