FlightClaw agents

Search, price-track and book flights from your AI assistant. FlightClaw covers
about 300 airlines, remembers your travellers and preferences, and emails you
when a tracked fare drops.

Option 1: Hosted MCP (recommended)

Server URL: https://mcp.flightclaw.com/mcp (streamable HTTP, OAuth sign-in).
Nothing to install.

Hosted tools

Booking and payment

1. search_flights returns offers. Each total_amount includes the FlightClaw booking fee.
2. create_checkout returns a checkout_url and the exact total_amount + total_currency. Nothing is charged yet.
3. Pay one of two ways:
   • Checkout link: the traveller opens checkout_url and pays by card.
   • Headless with Stripe Link: the agent creates a Link spend request for exactly
     total_amount (fare + booking fee), the user approves it in Link, and the agent pays
     on checkout_url with the Link shared payment token / virtual card. The agent never
     pays more than the approved amount.
4. get_checkout_status until completed, then get_order for the booking reference.

The agent never asks for card numbers.

Option 2: Local open-source server

The rest of this README covers the self-hosted Python server in this repo.
It searches Google Flights and tracks prices locally with no account.

Local MCP server

FlightClaw runs as a local MCP server, giving any MCP-compatible client (Claude Code, Claude Desktop, etc.) access to flight search and tracking tools.

Setup

# Install dependencies
pip install "flights==0.9.0" "mcp[cli]<2" fastmcp pydantic-settings

# Add to Claude Code
claude mcp add flightclaw -- python3 /path/to/agents/server.py

Or in Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "flightclaw": {
      "command": "python3",
      "args": ["/path/to/agents/server.py"]
    }
  }
}

Tools

Search filters

All search tools support:

• Passengers - adults, children, infants (in seat or on lap)
• Airlines - filter to specific carriers (e.g. BA,AA,DL)
• Price limit - max price in USD
• Duration - max total flight time in minutes
• Times - earliest/latest departure and arrival hours
• Layovers - max layover duration in minutes
• Sorting - by BEST, CHEAPEST, DEPARTURE, ARRIVAL, or DURATION
• Multi-airport - comma-separated codes (e.g. LHR,MAN)
• Date ranges - date_to for searching each day in a range

Example prompts

• "Search flights from LHR to JFK on 2025-08-01 in business class"
• "Find nonstop BA or VS flights LHR to JFK departing after 8am"
• "What are the cheapest dates to fly LHR to JFK in July?"
• "Search for 2 adults and 1 child, LHR to JFK, under $500"
• "Track LHR to SFO on 2025-07-01 with a target price of $400"
• "Check my tracked flights for price drops"

CLI Scripts

The original CLI scripts are still available in scripts/:

# Search flights
python scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS

# Multiple airports and date ranges
python scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-05

# Track a route
python scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400

# Check for price drops (good for cron)
python scripts/check-prices.py --threshold 5

# List tracked flights
python scripts/list-tracked.py

How it works

• Queries Google Flights via the fli library
• Prices returned in user's local currency (auto-detected from IP)
• Price history persists in data/tracked.json
• Supports one-way and round trips, all cabin classes (economy to first)
• Filter by airline, price, duration, departure/arrival times, layover duration
• Multi-airport and date-range searches expand into all combinations
• Date search finds the cheapest day to fly across a range

Install (OpenClaw)

npx skills add flightclaw/agents

Install (Grok)

/plugin marketplace add xai-org/plugin-marketplace
/plugin install flightclaw

Install (Claude Code)

/plugin marketplace add flightclaw/agents
/plugin install flightclaw@flightclaw

Install (Cursor)

/plugin marketplace add flightclaw/agents
/plugin install flightclaw

Install (Gemini CLI)

gemini extensions install https://github.com/flightclaw/agents

Each client reads its own manifest from this repo — .grok-plugin/,
.claude-plugin/, .cursor-plugin/ and gemini-extension.json — and they all
connect to the hosted server at https://mcp.flightclaw.com/mcp. To run the
local server instead, use the setup in "Local MCP server" above.

The local server

The local server runs server.py through uv, which resolves the pinned
dependencies at start-up. Install uv first; no
other setup step runs on your machine.

What the local server reaches, and what it needs

Search and price tracking work with no credentials at all. Every other group of
tools stays inactive until its variables are set:

FlightClaw reads no other environment variable, writes only to its own data/
directory, and runs no install-time script.

License

MIT — see LICENSE.