Flight Search
Search Google Flights through SerpApi: one-way and round-trip flights by IATA airport code.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
mcp-flight-searchclaude mcp add flight-search -e 'SERP_API_KEY=<your serp_api_key>' -- uvx mcp-flight-search==0.3.0
{
"mcpServers": {
"flight-search": {
"command": "uvx",
"args": [
"mcp-flight-search==0.3.0"
],
"env": {
"SERP_API_KEY": "<your serp_api_key>"
}
}
}
}
Environment variables
SERP_API_KEYrequired secret Your SerpApi key (serpapi.com)
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
MCP Flight Search
An MCP server that searches Google Flights through SerpApi, for Claude, Cursor and other MCP clients. One-way and round-trip searches by IATA airport code, with prices, durations, stops and times.
Requirements
- Python 3.10 or later (or uv)
- A SerpApi key in
SERP_API_KEY(serpapi.com has a free tier)
Use it from an MCP client
Add it to your client's MCP configuration (Claude Desktop, Claude Code, Cursor, ...):
{
"mcpServers": {
"flight-search": {
"command": "uvx",
"args": ["mcp-flight-search"],
"env": { "SERP_API_KEY": "your-serpapi-key" }
}
}
}
Or install it with pip install mcp-flight-search and use "command": "mcp-flight-search".
Run it yourself
export SERP_API_KEY="your-serpapi-key"
mcp-flight-search # stdio (default)
mcp-flight-search --connection_type http --port 3001 # Streamable HTTP at http://127.0.0.1:3001/mcp
LOG_LEVEL=DEBUG shows more detail on stderr. The API key is never logged.
With Docker:
docker build -t mcp-flight-search .
docker run -i --rm -e SERP_API_KEY=your-serpapi-key mcp-flight-search
Tools
| Tool | What it does |
|---|---|
search_flights_tool | Flights between two airports. origin, destination: IATA codes such as ATL, LAX. outbound_date: YYYY-MM-DD. return_date (optional): YYYY-MM-DD for a round trip. Returns structured results: airline, price (USD), duration, stops, departure, arrival, cabin class. |
server_status | Checks the server is running and reports its version. |
Development
uv sync
uv run pytest
uv run ruff check .
License
MIT
Frequently asked questions
What is Flight Search?
Search Google Flights through SerpApi: one-way and round-trip flights by IATA airport code.
How do I install Flight Search?
It runs on your machine. In Claude Code: claude mcp add flight-search -e 'SERP_API_KEY=<your serp_api_key>' -- uvx mcp-flight-search==0.3.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Flight Search need an API key?
Yes. It expects SERP_API_KEY, which you set in its configuration.
Is Flight Search open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Flight Search?
It is published by arjunprabhulal. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.