Flights Mcp Server

What is Flights Mcp Server?

Flights Mcp Server is a Model Context Protocol (MCP) implementation that connects AI agents and LLMs to Google Flights data. It provides tools to retrieve comprehensive flight information, find the cheapest available flights, filter by time constraints, and get Google Flights' best recommendations. It is designed for developers and users who want to integrate flight search capabilities into MCP-compatible clients like Claude Desktop or Cursor.

How to use Flights Mcp Server?

Clone the repository and install the uv package manager. Then configure the server in your MCP client by adding a JSON entry to claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor) with the uv command and the absolute path to the flights.py script. After restarting the client, the MCP tools become available for natural language queries.

Key features of Flights Mcp Server

• Retrieve comprehensive flight information for a route
• Find the cheapest available flight options
• Get Google Flights' recommended best flights
• Filter flights by specific time constraints
• Support for one-way trips (round-trip simulated as two one-ways)
• Configurable parameters: seat type, number of passengers, infants

Use cases of Flights Mcp Server

• Search for direct flights from Atlanta to Shanghai on a specific date
• Compare prices for flights from Detroit to Atlanta over a weekend
• Find the cheapest flight options from New York to Japan leaving this Friday
• Filter LAX flights to show only departures after 8:00 PM

FAQ from Flights Mcp Server

Does it support round-trip flights?

Currently, the tool only handles one-way trips. If you ask for a round-trip, it will search two one-way flights – one for each direction.

What parameters are required?

You must provide the origin and destination airport IATA codes (e.g., "ATL", "JFK") and a departure date in YYYY-MM-DD format. Optional parameters include trip type, seat class, number of adults, children, and infants.

What clients can I use with this server?

The server is compatible with Claude Desktop and Cursor. Setup instructions for both are provided in the README, including configuration files for MCP.

Is this project affiliated with Google?

No. This project is a third-party, community-built tool and is not endorsed by or affiliated with Google, Google Flights, or any Alphabet subsidiary.

What runtime is required?

The server requires Python and the uv package manager. Installation instructions for uv on macOS and Windows are included in the README.