# flightclaw

> Free, open-source flight price tracking skill for OpenClaw agents and an MCP server for Claude Code, Claude Desktop, Cursor, Cline, and any MCP-compatible client. Searches Google Flights directly (no API key, no cost), tracks routes over time, and alerts you when prices drop below a target.

## What it does

flightclaw lets your AI agent:

- Search Google Flights for any route, date, cabin (economy / premium / business / first), and stop count
- Find the cheapest day to fly across a date range (calendar search)
- Track routes persistently with optional target prices
- Refresh tracked routes on a schedule and surface price drops
- Alert via Telegram, Discord, Slack, or any channel your agent can write to
- Run as an OpenClaw skill OR an MCP server

## Install

OpenClaw skill:

```bash
npx skills add jackculpan/flightclaw
```

MCP server (Claude Code):

```bash
git clone https://github.com/jackculpan/flightclaw
cd flightclaw
pip install flights "mcp[cli]"
claude mcp add flightclaw -- python3 server.py
```

MCP server (Claude Desktop) — add to claude_desktop_config.json:

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

## MCP tools exposed

- `search_flights` — find flights for a route and date with cabin / stop / airline / time filters
- `search_dates` — cheapest-date calendar across a date range
- `track_flight` — persistent route tracking with optional target price
- `check_prices` — refresh tracked routes, return price drops
- `list_tracked` — all tracked routes with current vs starting price
- `remove_tracked` — stop watching a route

Filters supported in `search_flights`: passengers (adults / children / infants), airline, max price, max flight duration, departure window, arrival window, layover length, sort order.

## Example prompts

- "find nonstop flights LHR to JFK in july, business class"
- "track BA 117 LHR to JFK on july 1, alert me under $400"
- "what's the cheapest day to fly london to new york in summer?"
- "check all my tracked flights for price drops"
- "search flights with no more than one stop, departing before 10am"

## Use cases

- Personal travel planning with persistent price monitoring
- Award travel research (cash baseline for points valuations)
- Multi-city itinerary cost comparison
- Repositioning flight searches across alternate airports

## Pricing & data

flightclaw uses the open-source `fli` library to query Google Flights directly. There is no API key, no third-party flight API cost. Prices return in the user's local currency, auto-detected from IP. Tracked routes persist locally in `data/tracked.json` — no cloud account, no telemetry.

## Pages

- [Homepage](https://flightclaw.com) — overview and demo
- [MCP server reference](https://flightclaw.com/mcp) — full tool list, install snippets, config for Claude Code, Claude Desktop, Cursor, Cline
- [Claude Code install guide](https://flightclaw.com/claude-code) — step-by-step setup with example workflows

## FAQ

### What is flightclaw?
A free, open-source skill for OpenClaw and an MCP server for Claude Code / Claude Desktop. Lets your AI agent search Google Flights, track routes over time, and alert when prices drop.

### How does flightclaw work?
You tell your agent which route to track and set a target price. flightclaw searches Google Flights on a schedule, persists price history locally, and surfaces drops via your agent.

### Is flightclaw free?
Yes. Completely free and open source under the MIT license. No API keys, no rate-limit costs.

### What agents does flightclaw work with?
OpenClaw agents (as a skill); Claude Code, Claude Desktop, Cursor, Cline, Continue, and any MCP-compatible client (as an MCP server).

### How does flightclaw search flights without an API key?
Uses the open-source `fli` library, which queries Google Flights directly via the public web interface.

### Where does price history go?
Stored locally in `data/tracked.json` on the machine running the skill. No cloud, no third-party data sharing.

### Does flightclaw book flights?
The skill integrates with Duffel for booking via a separate flow.

### What currencies are supported?
Auto-detected from your IP location. Returned with the correct symbol ($, £, €, ¥, etc.) and ISO currency code.

## Links

- Website: https://flightclaw.com
- GitHub (skill): https://github.com/jackculpan/flightclaw
- OpenClaw: https://github.com/openclaw/openclaw
- MCP spec: https://modelcontextprotocol.io
- fli library: https://github.com/punitarani/fli