smamidipaka6/flights-mcp-server

A Model Context Protocol (MCP) server implementation that connects your Agents or LLMs to Google Flights data. Access flight information, find the cheapest options, filter by time restrictions, and get Google Flights' best recommendations!
## 🌍 Overview
This MCP server provides seamless access to Google Flights data, enabling your AI agents to:
Retrieve Comprehensive Flight Info
Find the Cheapest Available Flights
Filter flights based on Specific Time Constraints
Get Google Flights' recommended Best Flights
> Note: Currently, this tool only does one-ways (if you ask for a round-trip, it'll do two one-ways though!) as I built it as a fun pet project to learn about MCPs.
> If anyone actually finds this useful or wants me to, I can work on adding Round-Trip and Multi-City functionality!! Just raise a PR or hit me up!
## 🎥 Usage & Demo
Just follow the Quick Start to set this up for Claude Desktop, Cursor, or another MCP Client and just ask away to find out about your desired flight info!!
[Insert Claude Desktop Demo Video]
## 🛠️ Tools
### Available Functions/Tools
1. get_general_flights_info(): Retrieve comprehensive flight information for a given route
Provides detailed flight details for up to 40 flights
Returns a list of human-readable flight descriptions
2. get_cheapest_flights(): Find the most affordable flight options
Sorts and returns flights by lowest price
Includes current overall route pricing information
3. get_best_flights(): Get Google Flights' top recommended flights
Identifies and returns flights marked as "best" by Google Flights
Helps users find optimal flight choices
4. get_time_filtered_flights(): Filter flights by specific time constraints
Search for flights before or after a target time
Allows precise scheduling preferences
### Input Parameters
#### Required Parameters
origin: str - Origin airport IATA code (e.g., "ATL", "SCL", "JFK")
destination: str - Destination airport IATA code (e.g., "DTW", "ICN", "LIR")
departure_date: str - Departure date in YYYY-MM-DD format
#### Optional Parameters
trip_type: str - Trip type, either "one-way" or "round-trip" (default: "one-way")
seat: str - Seat type: "economy", "premium-economy", "business", or "first" (default: "economy")
adults: int - Number of adult passengers (default: 1)
children: int - Number of child passengers (default: 0)
infants_in_seat: int - Number of infants requiring a seat (default: 0)
infants_on_lap: int - Number of infants traveling on a lap (default: 0)
#### Additional Parameters for Specific Functions
n_flights: int - Number of flights to return (default: 40, only for get_general_flights_info())
state: str - Time filter state, either "before" or "after" (only for get_time_filtered_flights())
target_time_str: str - Target time in HH:MM AM/PM format (only for get_time_filtered_flights())
## ⚡ Quick Start
### Claude Desktop
1. Make sure you have the latest Claude for Desktop downloaded!
2. Clone This Repo
3. Install uv to set up our Python Environment
#### MacOS
bash
# Check if uv is already installed
uv --version
# If not installed
curl -LsSf https://astral.sh/uv/install.sh | sh
#### Windows
powershell
# Check if uv is already installed
uv --version