# Google Flights

> Google Flights is a free MCP server for maps and travel. Search Google Flights prices, find the cheapest travel dates and look up airport codes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://thiagolannes.com
- **Repository:** https://github.com/thiagojacoblannes/google-flights-mcp
- **MCP Registry name:** io.github.ThiagoJacobLannes/google-flights-mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-15

## About

It works with no API key by default, using the fast-flights library to query Google Flights. Setting SERPAPI_KEY switches to SerpApi automatically, which adds flight numbers, layover detail and carbon emissions. Defaults are set by GOOGLE_FLIGHTS_DEFAULT_ORIGIN (LIS) and GOOGLE_FLIGHTS_DEFAULT_CURRENCY (EUR).

search_flights takes origin, destination, dates, passengers, cabin class, currency, max stops and sort order, returning price-ranked options with a Google Flights link. cheapest_dates scans up to a 21-day window by running one search per day. airport_search resolves a city name to an IATA code offline.

Known limits: return searches show outbound options with an estimated round-trip total, and EU or UK requests meet a cookie-consent page the default provider rejects automatically. It needs Python 3.11 or later, or uvx.

## Features

- **Price-ranked search:** Results with airline, times, duration and stops.
- **Cheapest dates:** Scan a window of up to 21 days.
- **Airport lookup:** City names to IATA codes offline.
- **Two data sources:** Keyless scraper or SerpApi.
- **Booking links:** Each result links to Google Flights.
- **Configurable defaults:** Set home airport and currency.

## Good for

- Find the cheapest day to fly in a month
- Compare nonstop and one-stop fares
- Look up an airport code
- Price a round trip estimate

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-flights-mcp -- uvx google-flights-search-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-flights-mcp": {
      "command": "uvx",
      "args": [
        "google-flights-search-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "google-flights-mcp": {
      "command": "uvx",
      "args": [
        "google-flights-search-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "google-flights-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "google-flights-search-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "google-flights-mcp": {
      "command": "uvx",
      "args": [
        "google-flights-search-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "google-flights-mcp": {
      "command": "uvx",
      "args": [
        "google-flights-search-mcp"
      ]
    }
  }
}
```

## Tools

- `search_flights`: Search flights and rank by price.
- `cheapest_dates`: Find the cheapest days in a date window.
- `airport_search`: Resolve a city or airport to an IATA code.

## FAQ

### Is an API key needed?

No; SerpApi is optional.

### How wide can the date scan be?

Up to 21 days.

### How are round trips priced?

Outbound options with an estimated round-trip total.

### How do I install it?

claude mcp add google-flights -- uvx google-flights-search-mcp.

### Is Google Flights free?

Yes. Google Flights is free to use.

### How do I add Google Flights to Claude Code?

Run this command in your terminal: claude mcp add google-flights-mcp -- uvx google-flights-search-mcp

### What are the best alternatives to Google Flights?

The closest alternatives to Google Flights are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/google-flights-3
