iflow-mcp_smamidipaka6-google-flights-mcp-server 0.1.0__py3-none-any.whl

flights.py

@@ -0,0 +1,517 @@
+from typing import Any
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+from fast_flights import FlightData, Passengers, Result, get_flights, search_airport
+from dataclasses import asdict
+
+from datetime import datetime
+
+
+# initialize the MCP server
+mcp = FastMCP("flights")
+
+
+# Helper Functions
+
+def format_flight_info(flight_data, origin_airport, destination_airport):
+    """
+    Formats flight information into a human-readable string.
+
+    Args:
+        flight_data: Dictionary containing flight information
+        origin_airport: Name of Origin airport city and IATA code (ex: "Seattle (SEA)")
+        destination_airport: Name of Destination airport city and IATA code (ex: "Tokyo (HND)")
+
+    Returns:
+        Formatted string describing the flight
+    """
+
+    duration_parts = flight_data['duration'].split()
+
+    if len(duration_parts) == 4:
+        duration_formatted = f"{duration_parts[0]} hours and {duration_parts[2]} minutes"
+    else:
+        duration_formatted = flight_data['duration']
+
+    # Reformat departure and arrival dates
+    def expand_date(date_str):
+        # Map abbreviated month and day
+        month_map = {
+            'Jan': 'January', 'Feb': 'February', 'Mar': 'March',
+            'Apr': 'April', 'May': 'May', 'Jun': 'June',
+            'Jul': 'July', 'Aug': 'August', 'Sep': 'September',
+            'Oct': 'October', 'Nov': 'November', 'Dec': 'December'
+        }
+        day_map = {'Mon': 'Monday', 'Tue': 'Tuesday', 'Wed': 'Wednesday',
+                   'Thu': 'Thursday', 'Fri': 'Friday', 'Sat': 'Saturday',
+                   'Sun': 'Sunday'}
+
+        parts = date_str.split()
+        time = f"{parts[0]} {parts[1]}"  # "9:40 AM"
+
+        # Handle the day abbreviation (removing the comma)
+        day_abbr = parts[3].rstrip(',')  # "Sat" (removing comma from "Sat,")
+        month_abbr = parts[4]  # "Apr"
+        day = parts[5]  # "5"
+
+        full_day = day_map.get(day_abbr, day_abbr)
+        full_month = month_map.get(month_abbr, month_abbr)
+
+        # Add ordinal suffix to the day
+        day_with_suffix = day + ('th' if not day.endswith(('1', '2', '3')) or day.endswith(('11', '12', '13')) else
+                                 ('st' if day.endswith('1') else
+                                  ('nd' if day.endswith('2') else
+                                   ('rd' if day.endswith('3') else 'th'))))
+
+        return f"{time} on {full_day}, {full_month} {day_with_suffix}"
+
+    # Determine best flight qualifier
+    best_flight_qualifier = "considered one of the best options by Google Flights" if flight_data['is_best'] else "an available option"
+
+    # Handle potential None or empty values
+    stops = flight_data["stops"]
+    stops_text = f"{stops} stop{'s' if stops != 1 else ''}" if stops > 0 else "non-stop"
+
+    formatted_string = (
+        f"This flight departs at {expand_date(flight_data['departure'])} from {origin_airport}, local time, "
+        f"and arrives at {expand_date(flight_data['arrival'])} in {destination_airport}, local time. "
+        f"The flight is operated by {flight_data['name']} and has a duration of {duration_formatted} "
+        f"with {stops_text} in between. "
+        f"And it's price is {flight_data['price']} and is {best_flight_qualifier}!"
+    )
+
+    return formatted_string
+
+
+
+
+
+# Main Functions
+
+@mcp.tool()
+async def get_general_flights_info(origin: str, destination: str, departure_date: str,
+                      trip_type: str = "one-way", seat: str = "economy",
+                      adults: int = 1, children: int = 0, infants_in_seat: int = 0, infants_on_lap: int = 0,
+                      n_flights: int = 40) -> list[str]:
+    """ Get general/comprehensive flight information for N flights for a given origin, destination, and departure date. If the user wants to do a round-trip,
+    you will need to make two one-way trip calls.
+
+    Args:
+        origin (str): The origin airport IATA code (ex: "ATL", "SCL", "JFK").
+        destination (str): The destination airport IATA code (ex: "DTW", "ICN", "LIR").
+        departure_date (str): The departure date in YYYY-MM-DD format.
+
+        trip_type (str, optional): The type of trip ("one-way" or "round-trip" only). Defaults to "one-way".
+        seat (str, optional): The type of seat ("economy", "premium-economy", "business", or "first" only). Defaults to "economy".
+        adults (int, optional): The number of adults. Defaults to 1.
+        children (int, optional): The number of children. Defaults to 0.
+        infants_in_seat (int, optional): The number of infants in a seat. Defaults to 0.
+        infants_lap (int, optional): The number of infants on a lap. Defaults to 0.
+
+        n_flights (int, optional): The number of flights to return. Defaults to 25.
+
+    Returns:
+        list[str]: A list of flight information strings.
+    """
+
+    if (len(origin) != 3 or len(destination) != 3):
+        return "Origin and destination must be 3 characters."
+
+    if (len(departure_date) != 10 or departure_date[4] != '-' or departure_date[7] != '-'):
+        return "Departure date must be in YYYY-MM-DD format."
+
+    if (trip_type != "one-way" and trip_type != "round-trip"):
+        return "Trip type must be either 'one-way' or 'round-trip'."
+
+    if (seat != "economy" and seat != "premium-economy" and seat != "business" and seat != "first"):
+        return "Seat type must be either 'economy', 'premium-economy', 'business', or 'first'."
+
+
+    try:
+
+        # Make API call to Google Flights via fast-flights
+
+        flight_data_input = [FlightData(date=departure_date, from_airport=origin, to_airport=destination)]
+
+        passengers_input = Passengers(adults=adults, children=children, infants_in_seat=infants_in_seat, infants_on_lap=infants_on_lap)
+
+        result: Result = get_flights(
+            flight_data=flight_data_input,
+            trip=trip_type,
+            seat=seat,
+            passengers=passengers_input,
+            fetch_mode="fallback"
+        )
+
+        result = asdict(result)
+
+        if not result or "flights" not in result:
+            return ["No flight data available for the specified route and dates."]
+
+        current_price = result["current_price"]
+        all_flights = result["flights"]
+
+        if not all_flights:
+            return ["No flights found for the specified route and dates."]
+
+        top_n_flights = all_flights[0: min(n_flights, len(all_flights))]
+
+        flight_info = []
+
+        origin_airport = origin
+        destination_airport = destination
+
+        for flight in top_n_flights:
+            flight_info.append(format_flight_info(flight, origin_airport, destination_airport))
+
+        output = [f"The current overall flight prices for this route and time are: {str(current_price)}."] + flight_info
+
+
+        return output
+
+
+    except httpx.RequestError:
+        return ["Unable to connect to the flight search service. Please try again later."]
+
+    except ValueError as e:
+        return [f"Invalid data received: {str(e)}"]
+
+    except Exception as e:
+        return [f"An unexpected error occurred while searching for flights: {str(e)}"]
+
+
+
+@mcp.tool()
+async def get_cheapest_flights(origin: str, destination: str, departure_date: str,
+                      trip_type: str = "one-way", seat: str = "economy",
+                      adults: int = 1, children: int = 0, infants_in_seat: int = 0, infants_on_lap: int = 0) -> list[str]:
+
+    """ Get the cheapest flight information for a given origin, destination, and departure date. If the user wants to do a round-trip,
+    you will need to make two one-way trip calls.
+
+    Args:
+        origin (str): The origin airport IATA code (ex: "ATL", "SCL", "JFK").
+        destination (str): The destination airport IATA code (ex: "DTW", "ICN", "LIR").
+        departure_date (str): The departure date in YYYY-MM-DD format.
+
+        trip_type (str, optional): The type of trip ("one-way" or "round-trip" only). Defaults to "one-way".
+        seat (str, optional): The type of seat ("economy", "premium-economy", "business", or "first" only). Defaults to "economy".
+        adults (int, optional): The number of adults. Defaults to 1.
+        children (int, optional): The number of children. Defaults to 0.
+        infants_in_seat (int, optional): The number of infants in a seat. Defaults to 0.
+        infants_lap (int, optional): The number of infants on a lap. Defaults to 0.
+
+    Returns:
+        list[str]: A list of flight information strings.
+    """
+
+    if (len(origin) != 3 or len(destination) != 3):
+        return "Origin and destination must be 3 characters."
+
+    if (len(departure_date) != 10 or departure_date[4] != '-' or departure_date[7] != '-'):
+        return "Departure date must be in YYYY-MM-DD format."
+
+    if (trip_type != "one-way" and trip_type != "round-trip"):
+        return "Trip type must be either 'one-way' or 'round-trip'."
+
+    if (seat != "economy" and seat != "premium-economy" and seat != "business" and seat != "first"):
+        return "Seat type must be either 'economy', 'premium-economy', 'business', or 'first'."
+
+    try:
+        # Make API call to Google Flights via fast-flights
+
+        flight_data_input = [FlightData(date=departure_date, from_airport=origin, to_airport=destination)]
+        passengers_input = Passengers(adults=adults, children=children, infants_in_seat=infants_in_seat, infants_on_lap=infants_on_lap)
+
+        result: Result = get_flights(
+            flight_data=flight_data_input,
+            trip=trip_type,
+            seat=seat,
+            passengers=passengers_input,
+            fetch_mode="fallback"
+        )
+
+        result = asdict(result)
+
+        if not result or "flights" not in result:
+            return ["No flight data available for the specified route and dates."]
+
+        all_flights = result["flights"]
+
+        if not all_flights:
+            return ["No flights found for the specified route and dates."]
+
+        def get_price_value(flight):
+
+            price_str = flight['price']
+
+            # Remove $ and any commas from the price string
+            price_str = price_str.replace('$', '')
+            price_str = price_str.replace(',', '')
+
+            # Convert to decimal number
+            return float(price_str)
+
+        price_sorted_flights = sorted(all_flights, key=get_price_value)
+
+        top_n_flights = price_sorted_flights[0: min(30, len(price_sorted_flights))]
+
+        flight_info = []
+
+        origin_airport = origin
+        destination_airport = destination
+
+        for flight in top_n_flights:
+            flight_info.append(format_flight_info(flight, origin_airport, destination_airport))
+
+        output = ["Here are the cheapest flights for this route and time: "] + flight_info
+
+
+        return output
+
+
+
+    except httpx.RequestError:
+        return ["Unable to connect to the flight search service. Please try again later."]
+
+    except ValueError as e:
+        return [f"Invalid data received: {str(e)}"]
+
+    except Exception as e:
+        return [f"An unexpected error occurred while searching for flights: {str(e)}"]
+
+
+@mcp.tool()
+async def get_best_flights(origin: str, destination: str, departure_date: str,
+                      trip_type: str = "one-way", seat: str = "economy",
+                      adults: int = 1, children: int = 0, infants_in_seat: int = 0, infants_on_lap: int = 0) -> list[str]:
+
+    """ Get the best flights as determined by Google Flights for a given origin, destination, and departure date. If the user wants to do a round-trip,
+    you will need to make two one-way trip calls.
+
+    Args:
+        origin (str): The origin airport IATA code (ex: "ATL", "SCL", "JFK").
+        destination (str): The destination airport IATA code (ex: "DTW", "ICN", "LIR").
+        departure_date (str): The departure date in YYYY-MM-DD format.
+
+        trip_type (str, optional): The type of trip ("one-way" or "round-trip" only). Defaults to "one-way".
+        seat (str, optional): The type of seat ("economy", "premium-economy", "business", or "first" only). Defaults to "economy".
+        adults (int, optional): The number of adults. Defaults to 1.
+        children (int, optional): The number of children. Defaults to 0.
+        infants_in_seat (int, optional): The number of infants in a seat. Defaults to 0.
+        infants_lap (int, optional): The number of infants on a lap. Defaults to 0.
+
+    Returns:
+        list[str]: A list of flight information strings.
+    """
+
+    if (len(origin) != 3 or len(destination) != 3):
+        return "Origin and destination must be 3 characters."
+
+    if (len(departure_date) != 10 or departure_date[4] != '-' or departure_date[7] != '-'):
+        return "Departure date must be in YYYY-MM-DD format."
+
+    if (trip_type != "one-way" and trip_type != "round-trip"):
+        return "Trip type must be either 'one-way' or 'round-trip'."
+
+    if (seat != "economy" and seat != "premium-economy" and seat != "business" and seat != "first"):
+        return "Seat type must be either 'economy', 'premium-economy', 'business', or 'first'."
+
+    try:
+        # Make API call to Google Flights via fast-flights
+
+        flight_data_input = [FlightData(date=departure_date, from_airport=origin, to_airport=destination)]
+
+        passengers_input = Passengers(adults=adults, children=children, infants_in_seat=infants_in_seat, infants_on_lap=infants_on_lap)
+
+        result: Result = get_flights(
+            flight_data=flight_data_input,
+            trip=trip_type,
+            seat=seat,
+            passengers=passengers_input,
+            fetch_mode="fallback"
+        )
+
+        result = asdict(result)
+
+        if not result or "flights" not in result:
+            return ["No flight data available for the specified route and dates."]
+
+        all_flights = result["flights"]
+
+        if not all_flights:
+            return ["No flights found for the specified route and dates."]
+
+        best_flights = []
+
+        for flight in all_flights:
+            if (flight['is_best']):
+                best_flights.append(flight)
+
+        if not best_flights:
+            return ["No best flights found for the specified route and dates."]
+
+
+        top_n_flights = best_flights[0: min(30, len(best_flights))]
+
+        flight_info = []
+
+        origin_airport = origin
+        destination_airport = destination
+
+        for flight in top_n_flights:
+            flight_info.append(format_flight_info(flight, origin_airport, destination_airport))
+
+        output = ["Here are the best flights for this route and time: "] + flight_info
+
+
+        return output
+
+
+
+    except httpx.RequestError:
+        return ["Unable to connect to the flight search service. Please try again later."]
+
+    except ValueError as e:
+        return [f"Invalid data received: {str(e)}"]
+
+    except Exception as e:
+        return [f"An unexpected error occurred while searching for flights: {str(e)}"]
+
+
+
+@mcp.tool()
+async def get_time_filtered_flights(state: str, target_time_str: str, origin: str, destination: str, departure_date: str,
+                      trip_type: str = "one-way", seat: str = "economy",
+                      adults: int = 1, children: int = 0, infants_in_seat: int = 0, infants_on_lap: int = 0) -> list[str]:
+
+    """ Get time-filtered flight information based on the user's preferences for before or after a certain time for a given origin, destination, and departure date. If the user wants to do a round-trip,
+    you will need to make two one-way trip calls.
+
+    Args:
+        state (str): The state of the flight ("before" or "after" only). For before, we do before the target time. For after, we do on or after the target time.
+        target_time_str (str): The target time in HH:MM AM/PM format (ex: "7:00 PM").
+        origin (str): The origin airport IATA code (ex: "ATL", "SCL", "JFK").
+        destination (str): The destination airport IATA code (ex: "DTW", "ICN", "LIR").
+        departure_date (str): The departure date in YYYY-MM-DD format.
+
+        trip_type (str, optional): The type of trip ("one-way" or "round-trip" only). Defaults to "one-way".
+        seat (str, optional): The type of seat ("economy", "premium-economy", "business", or "first" only). Defaults to "economy".
+        adults (int, optional): The number of adults. Defaults to 1.
+        children (int, optional): The number of children. Defaults to 0.
+        infants_in_seat (int, optional): The number of infants in a seat. Defaults to 0.
+        infants_lap (int, optional): The number of infants on a lap. Defaults to 0.
+
+    Returns:
+        list[str]: A list of flight information strings.
+    """
+
+    if (len(origin) != 3 or len(destination) != 3):
+        return "Origin and destination must be 3 characters."
+
+    if (len(departure_date) != 10 or departure_date[4] != '-' or departure_date[7] != '-'):
+        return "Departure date must be in YYYY-MM-DD format."
+
+    if (trip_type != "one-way" and trip_type != "round-trip"):
+        return "Trip type must be either 'one-way' or 'round-trip'."
+
+    if (seat != "economy" and seat != "premium-economy" and seat != "business" and seat != "first"):
+        return "Seat type must be either 'economy', 'premium-economy', 'business', or 'first'."
+
+    if (state != "before" and state != "after"):
+        return "State must be either 'before' or 'after'."
+
+    try:
+        # Validate time format first
+
+        try:
+            target_time = datetime.strptime(target_time_str, '%I:%M %p').time()
+        except ValueError:
+            return ["Invalid time format. Please use HH:MM AM/PM format (e.g., '7:00 PM')."]
+
+
+        # Make API call to Google Flights via fast-flights
+        flight_data_input = [FlightData(date=departure_date, from_airport=origin, to_airport=destination)]
+
+        passengers_input = Passengers(adults=adults, children=children, infants_in_seat=infants_in_seat, infants_on_lap=infants_on_lap)
+
+        result: Result = get_flights(
+            flight_data=flight_data_input,
+            trip=trip_type,
+            seat=seat,
+            passengers=passengers_input,
+            fetch_mode="fallback"
+        )
+
+        result = asdict(result)
+
+        if not result or "flights" not in result:
+            return ["No flight data available for the specified route and dates."]
+
+
+        all_flights = result["flights"]
+
+        if not all_flights:
+            return ["No flights found for the specified route and dates."]
+
+
+        valid_flights = []
+
+        for flight in all_flights:
+
+            parts = flight['departure'].split(" ")
+            time_str = parts[0] + " " + parts[1]
+
+            flight_time = datetime.strptime(time_str, '%I:%M %p').time()
+
+            if (state == "before"):
+                if (flight_time < target_time):
+                    valid_flights.append(flight)
+            elif (state == "after"):
+                if (flight_time >= target_time):
+                    valid_flights.append(flight)
+
+        if not valid_flights:
+            return [f"No flights found {state} {target_time_str} for the specified route and dates."]
+
+
+        top_n_flights = valid_flights[0: min(30, len(valid_flights))]
+
+        flight_info = []
+
+        origin_airport = origin
+        destination_airport = destination
+
+        for flight in top_n_flights:
+            flight_info.append(format_flight_info(flight, origin_airport, destination_airport))
+
+        context_str = f"Here are the time-filtered flights {('before' if state == 'before' else 'on or after')} {target_time_str}: "
+
+        output = [context_str] + flight_info
+
+
+        return output
+
+
+    except httpx.RequestError:
+        return ["Unable to connect to the flight search service. Please try again later."]
+
+    except ValueError as e:
+        return [f"Invalid data received: {str(e)}"]
+
+    except Exception as e:
+        return [f"An unexpected error occurred while searching for flights: {str(e)}"]
+
+
+
+
+
+
+def main():
+    # Initialize and run the server
+    mcp.run(transport='stdio')
+
+
+if __name__ == "__main__":
+    main()

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,303 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_smamidipaka6-google-flights-mcp-server
+Version: 0.1.0
+Summary: Google Flights MCP Server !!
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fast-flights>=2.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=1.3.0
+Dynamic: license-file
+
+# Google 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**
+
+<br>
+
+> **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](https://sahit-personal-website.vercel.app/)!
+
+## 🎥 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](https://claude.ai/download) 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
+
+   # If not installed
+   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+   ⚠️ IMPORTANT: After installation, you must restart your terminal for the `uv` command to get picked up!
+
+
+4. Add this flights MCP Server to your Claude for Desktop config:
+
+   #### MacOS
+
+   - Navigate to the config file location via Terminal: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - OR if you have VSCode adn the Code alias, you can just create/edit using:
+
+   ```bash
+   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
+   ```
+
+   #### Windows
+
+   - Navigate to the config file location via PowerShell: `%AppData%\Claude\claude_desktop_config.json`
+   - OR if you have VSCode adn the Code alias, you can just create/edit using:
+
+   ```powershell
+   code $env:AppData\Claude\claude_desktop_config.json
+   ```
+
+   Note: `~/Library/Application Support/Claude/config.json` is a different, unrelated file. Do not edit it.
+
+5. Add this flights MCP Server in the `mcpServers` key:
+
+   ```json
+   {
+     "mcpServers": {
+       "flights": {
+         "command": "/ABSOLUTE/PATH/.local/bin/uv",
+         "args": [
+           "--directory",
+           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
+           "run",
+           "flights.py"
+         ]
+       }
+     }
+   }
+   ```
+
+   Make sure to modify the code to include the Absolute Path for `uv` for the `command` param and for the Absolute Path for the `args` param to this Repo.
+
+    You may need to put the full path to the `uv` executable in the command field. You can get this by running:
+    - `which uv` on MacOS/Linux
+    - `where uv` on Windows
+
+    Example:
+
+   ```json
+   {
+     "mcpServers": {
+       "flights": {
+         "command": "/Users/sahitmamidipaka/.local/bin/uv",
+         "args": [
+           "--directory",
+           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
+           "run",
+           "flights.py"
+         ]
+       }
+     }
+   }
+   ```
+
+
+
+
+
+6. That's it! Open Claude for Desktop and you should see the little MCP Tools icon appear (make sure to re-open the app for updates to take place—you'll need to do this whenever you change your `claude_desktop_config.json` file 😊)
+
+<!-- Claude Desktop MCP Tools Icon -->
+<img src="./assets/images/claude-mcp-tool.png" alt="Claude Desktop MCP Tools Icon" />
+
+For more information, refer to the [Official MCP Documentation](https://modelcontextprotocol.io/quickstart/server).
+<br>
+
+### Cursor
+
+1. Open Cursor & Go to Settings
+
+2. Press the MCP Tab on the Left Panel
+
+3. Add a new MCP Server (Choose one):
+
+   #### Project Configuration
+
+   - Create a `.cursor/mcp.json` file in your project directory
+   - Ideal for tools specific to a single project
+
+   #### Global Configuration
+
+   - Create a `~/.cursor/mcp.json` file in your home directory
+   - Makes MCP servers available across all Cursor workspaces
+
+4. Attach the following configuration in the `mcp.json` file:
+
+   ```json
+   {
+     "mcpServers": {
+       "flights": {
+         "command": "uv",
+         "args": [
+           "--directory",
+           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
+           "run",
+           "flights.py"
+         ]
+       }
+     }
+   }
+   ```
+
+   Make sure to replace `/ABSOLUTE/PATH/TO/PARENT/FOLDER` with the actual path to this repo.
+
+   You may need to put the full path to the `uv` executable in the command field. You can get this by running:
+    - `which uv` on MacOS/Linux
+    - `where uv` on Windows
+
+   Example:
+
+   ```json
+   {
+     "mcpServers": {
+       "flights": {
+         "command": "/Users/sahitmamidipaka/.local/bin/uv",
+         "args": [
+           "--directory",
+           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
+           "run",
+           "flights.py"
+         ]
+       }
+     }
+   }
+   ```
+
+
+<!-- Cursor MCP Image -->
+<img src="./assets/images/cursor-mcp.png" alt="Cursor Flights MCP Image" />
+
+For more information, refer to the [Official Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol).
+
+
+## 🚀 Example Usage
+
+- Show me flight options from Atlanta to Shanghai for Jan 1 2026
+- What are the prices like for flights from Detroit to Atlanta this weekend?
+- I live in New York and want to go to Japan. Find the cheapest flight options leaving this Friday and consider all airports near me!
+- Show me flight options for LAX today but only after 8:00 PM
+
+## ✨ Upcoming Features
+
+- Better Roundtrip Functionality 🚀
+- Multi-City Functionality 🌍
+- Explore / Go Anywhere Functionality 🗺️
+- Price Graphs & Price History 📈
+
+## 🤝 Contributing
+
+Feel free to:
+
+- Open issues for bugs or feature requests
+- Submit pull requests
+- Contact me directly at sahit.mamidipaka@gmail.com
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+This means you are free to:
+
+- Use the software commercially
+- Modify the source code
+- Distribute the software
+- Use the software privately
+
+You must include the original copyright notice and citation in any distributed software or derivative works, as per the terms of the MIT License.
+
+---
+
+Thank you for checking out this project! Always feel free to contact me for any reason.
+
+> **Note:** This project was created for fun and is in no way endorsed or affiliated with Google, Google Flights, or any other Alphabet subsidiary company.

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+flights.py,sha256=4wRRyyOGU65GXRLPrG2TOi4Te_PzAL741szt23hya1E,19975
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=fiXVGGNZTFUCGa7ZDKwcTUGYB9AcZz5RteInw7Jsh6M,1073
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/METADATA,sha256=UNgwie20eiEvNtpPJM34ZpogsUhaa2a8CMTD1AkzIwk,9262
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=n4cb6ZVRkSrtVdmRhkOBss1fM-Ur_i4p-38Sl7mxzeQ,45
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/top_level.txt,sha256=4UhBDaKwrvR_ys9zGgF9IR8_poFFE5KcNh0oJHTHc-8,8
+iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/RECORD,,

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+flights-mcp = flights:main

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sahit Mamidipaka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_smamidipaka6_google_flights_mcp_server-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+flights