flights-mcp

:airplane: An MCP server that lets LLMs search Google Flights, built on FastMCP and fast-flights.

Tools

search_flights

Searches one-way and round-trip flights. Omit return_date for a one-way search.

Key parameters:

Each result includes price, airlines, stops, timezone-correct total duration, per-segment details, CO2 estimates, and a google_flights_url reproducing the search so a user can book.

Related MCP server: fli

Install

The name flights-mcp on PyPI belongs to an unrelated project, so this server is not published to PyPI. Install it straight from GitHub instead:

uvx --from git+https://github.com/FredrikBakken/flights-mcp flights-mcp

To pin a specific release, append the tag:

uvx --from git+https://github.com/FredrikBakken/flights-mcp@v0.1.0 flights-mcp

Built wheels and sdists are also attached to each GitHub release, alongside a SHA256SUMS file, if you would rather install from an artifact:

uv tool install ./flights_mcp-0.1.0-py3-none-any.whl

Usage

The server speaks MCP over stdio, so it is normally launched by an MCP client rather than by hand. Register it in Zed's settings.json:

{
  "context_servers": {
    "flights": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "git+https://github.com/FredrikBakken/flights-mcp",
          "flights-mcp"
        ]
      }
    }
  }
}

Or, when working on a local checkout:

{
  "context_servers": {
    "flights": {
      "command": {
        "path": "uv",
        "args": ["run", "--directory", "/path/to/flights-mcp", "flights-mcp"]
      }
    }
  }
}

Configuration

Development

uv sync                # install dependencies
uv run pytest          # run the test suite
prek run --all-files   # lint, format, type check
mise run update        # upgrade tools and dependencies, refresh hooks

Releasing

CI runs the hooks, tests, and a build on every push and pull request.

To cut a release, bump the version and push a matching v* tag:

uv version --bump patch   # or minor / major
git commit -am "Release v0.1.1"
git tag v0.1.1
git push origin main --tags

The release workflow verifies that the tag matches the project version, runs the tests, then builds and attaches the wheel, sdist, and SHA256SUMS to a GitHub release.

Notes and caveats

• This scrapes Google Flights. There is no official API, so results reflect what Google currently serves and may change or be rate-limited. Treat prices as indicative and confirm via google_flights_url.

• Consent redirect. Requests from the EU/EEA get redirected to consent.google.com. The server sends Google's SOCS consent cookie to avoid this; if you still hit it, set FLIGHTS_MCP_PROXY.

• Multi-city is not supported. Google returns an empty result payload for multi-city queries through this scraping approach, so no such tool is exposed.

• Airport codes only. City names are not resolved; the calling model should map them to IATA codes.

• Not on PyPI. The flights-mcp name there is an unrelated Duffel-API project. Install from git or a GitHub release instead.