Google Flights MCP Server (com.pulsemcp/google-flights)

MCP server for searching Google Flights. It supports flight search with filtering, date-price grid pricing to find cheaper travel dates, and airport IATA code lookup by city, airport name, or partial code. The service is designed for use without an API key or authentication, with multi-passenger and multi-currency support.

🛠️ Key Features

Flight search with full filtering (cabin class, stops, sorting, pagination)
Date-price grid across approximately ~60 days
Airport IATA code lookup (city name, airport name, partial code)
No API key or authentication required
Multi-passenger support (adults, children, infants)
Multiple currency support
Built-in rate limiting to avoid throttling

🚀 Use Cases

Compare flight options for specific routes with filtering and pagination
Identify the cheapest travel dates using a date-price grid
Convert city or airport references into IATA codes for downstream tooling

⚡ Developer Benefits

Rate limiting included to reduce throttling risk
No authentication setup required
Query flexibility via sorting and filtering plus pagination

Google Flights MCP Server

MCP server for searching Google Flights. Provides flight search, date-price grids for finding cheapest travel dates, and airport IATA code lookup. No API key required.

Highlights

Flight search with full filtering (cabin class, stops, sorting, pagination)
Date-price grid for finding cheapest travel dates across ~60 days
Airport IATA code lookup by city name, airport name, or partial code
No API key or authentication required
Multi-passenger support (adults, children, infants)
Multiple currency support
Built-in rate limiting to avoid throttling
TypeScript with strict type checking

Capabilities

Tools

Tool	Description
`search_flights`	Search for flights with full filtering, sorting, and pagination
`get_date_grid`	Get a date-price grid showing the cheapest flight price for each day
`find_airport_code`	Look up airport IATA codes by city name, airport name, or partial code

Resources

Resource	Description
`google-flights://config`	Server configuration and available tools

Quick Start

Claude Desktop Configuration

If this is your first time using MCP Servers, make sure you have the Claude Desktop application and follow the official MCP setup instructions.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "google-flights-mcp-server"]
    }
  }
}

Restart Claude Desktop and you should be ready to go!

Example Usage

Search for flights:

code

"Find me the cheapest nonstop flights from SFO to LAX next Friday"

Find cheapest dates:

code

"When is the cheapest time to fly from JFK to London in March?"

Look up airport codes:

code

"What are the airport codes for Tokyo?"

Development

Install Dependencies

bash

npm install

Build

bash

npm run build

Running in Development Mode

bash

npm run dev

Testing

bash

# Run manual tests (hits real Google Flights)
npm run test:manual

Project Structure

code

google-flights/
├── local/                 # Local server implementation
│   ├── src/
│   │   └── index.ts      # Main entry point
│   └── package.json
├── shared/               # Shared business logic
│   ├── src/
│   │   ├── server.ts     # Server factory with DI
│   │   ├── tools.ts      # Tool registration
│   │   ├── tools/        # Individual tool implementations
│   │   ├── resources.ts  # Resource implementations
│   │   ├── flights-client/ # Google Flights client (protobuf + HTTP)
│   │   └── logging.ts
│   └── package.json
├── tests/                # Test suite
│   └── manual/           # Manual tests against real Google Flights
└── package.json          # Root workspace config

License

MIT