Skip to content
Back to search

flightclaw

MarketplaceWorks with Claude CodeGitHub

FlightClaw — flight search, price tracking and booking.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/flightclaw-agents/badge.svg)](/listings/flightclaw-agents)

HTML

<a href="/listings/flightclaw-agents"><img src="/api/listings/flightclaw-agents/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 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"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "flightclaw",
  3. "description": "FlightClaw — flight search, price tracking and booking.",
  4. "owner": {
  5. "name": "Jack Culpan",
  6. "url": "https://github.com/jackculpan"
  7. },
  8. "plugins": [
  9. {
  10. "name": "flightclaw",
  11. "source": "./",
  12. "description": "Search Google Flights, price-track routes and get alerts when fares drop, then book and pay through Duffel.",
  13. "homepage": "https://flightclaw.com",
  14. "repository": "https://github.com/flightclaw/agents",
  15. "license": "MIT",
  16. "category": "travel",
  17. "keywords": [
  18. "flightclaw",
  19. "flight claw",
  20. "flightclaw track"
  21. ]
  22. }
  23. ]
  24. }
README.md · README · 219 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # FlightClaw agents: book flights with AI
  2. Search, price-track and book flights from your AI assistant. FlightClaw is an
  3. AI flight booking agent and MCP server for Claude, ChatGPT, Cursor, VS Code and
  4. any MCP client. It covers about 300 airlines, finds cheap flights, remembers
  5. your travellers and preferences, and works as a flight price tracker that emails
  6. you when a tracked fare drops. Learn more at [flightclaw.com](https://flightclaw.com).
  7. ## Skills
  8. Agent skills for the hosted MCP server (`https://mcp.flightclaw.com/mcp`). Each
  9. skill tells the agent which tools to call, in which order, and when to ask the
  10. user first.
  11. | Skill | Use it to |
  12. |---|---|
  13. | [book-flight](skills/book-flight/SKILL.md) | Search, compare and book flights with AI, then pay by checkout link or Link virtual card |
  14. | [track-flight-price](skills/track-flight-price/SKILL.md) | Track a fare daily and get an email alert when the price drops |
  15. | [plan-group-trip](skills/plan-group-trip/SKILL.md) | Save travellers and groups, search multi-city trips and book everyone at once |
  16. | [manage-booking](skills/manage-booking/SKILL.md) | Find orders and booking references, quote changes and cancel with a refund quote |
  17. | [traveler-profile](skills/traveler-profile/SKILL.md) | Save you, companions, preferences, cards, points balances and trip history |
  18. The root [SKILL.md](SKILL.md) covers the local open-source server.
  19. ## Option 1: Hosted MCP (recommended)
  20. Server URL: `https://mcp.flightclaw.com/mcp` (streamable HTTP, OAuth sign-in).
  21. Nothing to install.
  22. | Client | Setup |
  23. |---|---|
  24. | Claude (web / desktop) | Settings > Connectors > Add custom connector > paste `https://mcp.flightclaw.com/mcp` |
  25. | ChatGPT | Settings > Apps & Connectors > Create (developer mode) > paste `https://mcp.flightclaw.com/mcp` |
  26. | Claude Code | `claude mcp add --transport http flightclaw https://mcp.flightclaw.com/mcp` |
  27. | Cursor | [One-click install](https://cursor.com/en/install-mcp?name=flightclaw&config=eyJ1cmwiOiJodHRwczovL21jcC5mbGlnaHRjbGF3LmNvbS9tY3AifQ%3D%3D), or add `{"mcpServers":{"flightclaw":{"url":"https://mcp.flightclaw.com/mcp"}}}` to `~/.cursor/mcp.json` |
  28. | VS Code | [One-click install](https://vscode.dev/redirect/mcp/install?name=flightclaw&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.flightclaw.com%2Fmcp%22%7D), or `code --add-mcp '{"name":"flightclaw","type":"http","url":"https://mcp.flightclaw.com/mcp"}'` |
  29. | Windsurf | Add `{"mcpServers":{"flightclaw":{"serverUrl":"https://mcp.flightclaw.com/mcp"}}}` to `~/.codeium/windsurf/mcp_config.json` |
  30. ### Hosted tools
  31. | Group | Tools |
  32. |---|---|
  33. | Search | `search_flights`, `search_multi_city`, `recommend_flights`, `get_offer`, `get_seat_map` |
  34. | Booking | `create_checkout`, `get_checkout_status`, `list_orders`, `get_order`, `request_change`, `cancel_order` |
  35. | Price tracking | `track_flight`, `list_tracked`, `remove_tracked` (checked daily, email alert on a drop) |
  36. | Profile | `get_me`, `set_me`, `save_traveler`, `list_travelers`, `get_traveler`, `delete_traveler`, `save_group`, `list_groups`, `get_group`, `delete_group`, `get_preferences`, `set_preferences`, `save_card`, `list_cards`, `delete_card`, `set_points_balance`, `list_points` |
  37. | Trips | `log_trip`, `list_trips`, `get_trip`, `trips_followup`, `record_trip_feedback` |
  38. | WiFi | `check_flight_wifi` (does a specific flight have WiFi or Starlink; data from seatwifi.com) |
  39. ### Booking and payment
  40. 1. `search_flights` returns offers. Each `total_amount` includes the FlightClaw booking fee.
  41. 2. `create_checkout` returns a `checkout_url` and the exact `total_amount` + `total_currency`. Nothing is charged yet.
  42. 3. Pay one of two ways:
  43. - **Checkout link**: the traveller opens `checkout_url` and pays by card.
  44. - **Link virtual card**: the agent creates a Link spend request for exactly
  45. `total_amount` (fare + booking fee), the user approves it in Link, and the agent pays
  46. on `checkout_url` with the Link virtual card. The agent never
  47. pays more than the approved amount.
  48. 4. `get_checkout_status` until `completed`, then `get_order` for the booking reference.
  49. The agent never asks for card numbers.
  50. ## Option 2: Local open-source server
  51. The rest of this README covers the self-hosted Python server in this repo.
  52. It searches Google Flights and tracks prices locally with no account.
  53. ## Local MCP server
  54. FlightClaw runs as a local [MCP](https://modelcontextprotocol.io) server, giving any MCP-compatible client (Claude Code, Claude Desktop, etc.) access to flight search and tracking tools.
  55. ### Setup
  56. ```bash
  57. # Install dependencies
  58. pip install "flights==0.9.0" "mcp[cli]<2" fastmcp pydantic-settings
  59. # Add to Claude Code
  60. claude mcp add flightclaw -- python3 /path/to/agents/server.py
  61. ```
  62. Or in Claude Desktop, add to `claude_desktop_config.json`:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "flightclaw": {
  67. "command": "python3",
  68. "args": ["/path/to/agents/server.py"]
  69. }
  70. }
  71. }
  72. ```
  73. ### Tools
  74. | Tool | Description |
  75. |------|-------------|
  76. | `search_flights` | Search Google Flights for prices on a route |
  77. | `search_dates` | Find cheapest dates to fly across a date range (calendar view) |
  78. | `track_flight` | Add a route to price tracking with optional target price |
  79. | `check_prices` | Check all tracked flights for price changes and alerts |
  80. | `list_tracked` | List all tracked flights with price history |
  81. | `remove_tracked` | Remove a route from tracking |
  82. | `check_flight_wifi` | Ask seatwifi.com whether a flight (e.g. UA1234) has WiFi or Starlink |
  83. ### Search filters
  84. All search tools support:
  85. - **Passengers** - adults, children, infants (in seat or on lap)
  86. - **Airlines** - filter to specific carriers (e.g. `BA,AA,DL`)
  87. - **Price limit** - max price in USD
  88. - **Duration** - max total flight time in minutes
  89. - **Times** - earliest/latest departure and arrival hours
  90. - **Layovers** - max layover duration in minutes
  91. - **Sorting** - by BEST, CHEAPEST, DEPARTURE, ARRIVAL, or DURATION
  92. - **Multi-airport** - comma-separated codes (e.g. `LHR,MAN`)
  93. - **Date ranges** - `date_to` for searching each day in a range
  94. ### Example prompts
  95. - "Search flights from LHR to JFK on 2025-08-01 in business class"
  96. - "Find nonstop BA or VS flights LHR to JFK departing after 8am"
  97. - "What are the cheapest dates to fly LHR to JFK in July?"
  98. - "Search for 2 adults and 1 child, LHR to JFK, under $500"
  99. - "Track LHR to SFO on 2025-07-01 with a target price of $400"
  100. - "Check my tracked flights for price drops"
  101. ## CLI Scripts
  102. The original CLI scripts are still available in `scripts/`:
  103. ```bash
  104. # Search flights
  105. python scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS
  106. # Multiple airports and date ranges
  107. python scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-05
  108. # Track a route
  109. python scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400
  110. # Check for price drops (good for cron)
  111. python scripts/check-prices.py --threshold 5
  112. # List tracked flights
  113. python scripts/list-tracked.py
  114. ```
  115. ## How it works
  116. - Queries Google Flights via the `fli` library
  117. - Prices returned in user's local currency (auto-detected from IP)
  118. - Price history persists in `data/tracked.json`
  119. - Supports one-way and round trips, all cabin classes (economy to first)
  120. - Filter by airline, price, duration, departure/arrival times, layover duration
  121. - Multi-airport and date-range searches expand into all combinations
  122. - Date search finds the cheapest day to fly across a range
  123. ## Install (OpenClaw)
  124. ```bash
  125. npx skills add flightclaw/agents
  126. ```
  127. ## Install (Grok)
  128. ```
  129. /plugin marketplace add xai-org/plugin-marketplace
  130. /plugin install flightclaw
  131. ```
  132. ## Install (Claude Code)
  133. ```
  134. /plugin marketplace add flightclaw/agents
  135. /plugin install flightclaw@flightclaw
  136. ```
  137. ## Install (Cursor)
  138. ```
  139. /plugin marketplace add flightclaw/agents
  140. /plugin install flightclaw
  141. ```
  142. ## Install (Gemini CLI)
  143. ```bash
  144. gemini extensions install https://github.com/flightclaw/agents
  145. ```
  146. Each client reads its own manifest from this repo — `.grok-plugin/`,
  147. `.claude-plugin/`, `.cursor-plugin/` and `gemini-extension.json` — and they all
  148. connect to the hosted server at `https://mcp.flightclaw.com/mcp`. To run the
  149. local server instead, use the setup in "Local MCP server" above.
  150. ## The local server
  151. The local server runs `server.py` through `uv`, which resolves the pinned
  152. dependencies at start-up. Install [uv](https://docs.astral.sh/uv/) first; no
  153. other setup step runs on your machine.
  154. ### What the local server reaches, and what it needs
  155. | Endpoint | Purpose | Credentials |
  156. |---|---|---|
  157. | `google.com/travel/flights` (via the `fli` library) | Flight search and price tracking | none |
  158. Search and price tracking need no credentials. `HOST` and `PORT` are only read in HTTP transport mode.
  159. FlightClaw reads no other environment variable, writes only to its own `data/`
  160. directory, and runs no install-time script.
  161. ## License
  162. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.