How do I install the Duffel skill?

Run npx skillmds@latest add johnalbertini14-glitch/duffel in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Duffel safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Duffel?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Duffel free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Duffel?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Duffel by johnalbertini14-glitch — Agent Skill

Name: Duffel
Rating: 4.2 (5 reviews)
Author: johnalbertini14-glitch

Duffel

Search, book, and manage flights via the Duffel Flights API. Covers 300+ airlines (NDC, GDS, LCC). Use when: (1) searching for flights between cities, (2) comparing prices and fare classes, (3) booking flights, (4) checking booking status, (5) cancelling bookings, (6) viewing seat maps, (7) looking up airport/city IATA codes. Supports one-way, round-trip, multi-passenger, cabin class filtering, and nonstop preferences.

File contents

Duffel Flights

Search, book, and manage flights across 300+ airlines via the Duffel API.

Setup

Set DUFFEL_TOKEN env var with your Duffel API access token. Get one at https://app.duffel.com → Developers → Access Tokens. Test tokens (prefix duffel_test_) use sandbox data with unlimited balance.

Commands

Search flights

python scripts/duffel.py search --from MIA --to LHR --date 2026-04-15
python scripts/duffel.py search --from MIA --to CDG --date 2026-03-15 --return-date 2026-03-22 --cabin business
python scripts/duffel.py search --from JFK --to LAX --date 2026-05-01 --nonstop --adults 2

Options: --cabin economy|premium_economy|business|first, --nonstop, --adults N, --children N, --infants N, --sort price|duration, --max-results N, --json

Results are numbered. Use the number with other commands.

View offer details

python scripts/duffel.py offer 3

Shows segments, baggage, fare conditions (refund/change), available extras.

Book a flight

python scripts/duffel.py book 3 --pax "RIBEIRO/FABIO MR 1977-01-31 fabio@ribei.ro +13059159687 BR m"

Pax format: LAST/FIRST TITLE DOB EMAIL PHONE NATIONALITY GENDER

TITLE: MR, MRS, MS, MISS, DR
GENDER: m or f
Multiple passengers: repeat --pax "..." for each

Payment uses Duffel account balance. Top up at https://app.duffel.com.

Check order status

python scripts/duffel.py order ord_0000XXXXX

Cancel order

python scripts/duffel.py cancel ord_0000XXXXX           # Quote (shows refund amount)
python scripts/duffel.py cancel ord_0000XXXXX --confirm  # Execute cancellation

Seat map

python scripts/duffel.py seatmap 3

Airport/city lookup

python scripts/duffel.py places "new york"

Typical workflow

search → browse numbered results
offer N → check details, baggage, conditions
book N --pax "..." → get PNR
order <id> → verify booking
cancel <id> → if needed

Notes

Offers expire (usually ~20 min). Re-search if expired.
Test mode: unlimited balance, bookings on "Duffel Airways" (fake airline).
Production: real airlines, real tickets. Balance must be funded.
All commands support --json for raw API output.
Last search saved to /tmp/duffel-last-search.json for index reference.
For API details, see references/api-guide.md and references/booking-flow.md.

---name: duffeldescription: Search, book, and manage flights via the Duffel Flights API. Covers 300+ airlines (NDC, GDS, LCC). Use when: (1) searching for flights between cities, (2) comparing prices and fare classes, (3) booking flights, (4) checking booking status, (5) cancelling bookings, (6) viewing seat maps, (7) looking up airport/city IATA codes. Supports one-way, round-trip, multi-passenger, cabin class filtering, and nonstop preferences.---# Duffel FlightsSearch, book, and manage flights across 300+ airlines via the Duffel API.## SetupSet `DUFFEL_TOKEN` env var with your Duffel API access token.Get one at https://app.duffel.com → Developers → Access Tokens.Test tokens (prefix `duffel_test_`) use sandbox data with unlimited balance.## Commands### Search flights```bashpython scripts/duffel.py search --from MIA --to LHR --date 2026-04-15python scripts/duffel.py search --from MIA --to CDG --date 2026-03-15 --return-date 2026-03-22 --cabin businesspython scripts/duffel.py search --from JFK --to LAX --date 2026-05-01 --nonstop --adults 2```Options: `--cabin economy|premium_economy|business|first`, `--nonstop`, `--adults N`, `--children N`, `--infants N`, `--sort price|duration`, `--max-results N`, `--json`Results are numbered. Use the number with other commands.### View offer details```bashpython scripts/duffel.py offer 3```Shows segments, baggage, fare conditions (refund/change), available extras.### Book a flight```bashpython scripts/duffel.py book 3 --pax "RIBEIRO/FABIO MR 1977-01-31 fabio@ribei.ro +13059159687 BR m"```Pax format: `LAST/FIRST TITLE DOB EMAIL PHONE NATIONALITY GENDER`- TITLE: MR, MRS, MS, MISS, DR- GENDER: m or f- Multiple passengers: repeat `--pax "..."` for eachPayment uses Duffel account balance. Top up at https://app.duffel.com.### Check order status```bashpython scripts/duffel.py order ord_0000XXXXX```### Cancel order```bashpython scripts/duffel.py cancel ord_0000XXXXX # Quote (shows refund amount)python scripts/duffel.py cancel ord_0000XXXXX --confirm # Execute cancellation```### Seat map```bashpython scripts/duffel.py seatmap 3```### Airport/city lookup```bashpython scripts/duffel.py places "new york"```## Typical workflow1. `search` → browse numbered results2. `offer N` → check details, baggage, conditions3. `book N --pax "..."` → get PNR4. `order <id>` → verify booking5. `cancel <id>` → if needed## Notes- Offers expire (usually ~20 min). Re-search if expired.- Test mode: unlimited balance, bookings on "Duffel Airways" (fake airline).- Production: real airlines, real tickets. Balance must be funded.- All commands support `--json` for raw API output.- Last search saved to `/tmp/duffel-last-search.json` for index reference.- For API details, see `references/api-guide.md` and `references/booking-flow.md`.

Frequently asked questions