get_flight_offersLABSCO SUMMARY
Real flight inventory behind a plainly phrased question.
One tool, and it is the one that counts: origin, destination, date and passengers go into Amadeus's Flight Offers Search and priced options come back. The search is live rather than cached, and the credentials come from a self-service app you create yourself.
What it is
A community-built bridge to the Amadeus Flight Offers Search API, using the official amadeus-python SDK. It takes an origin, a destination, a travel date and a ticket count, and returns the flight options Amadeus holds, with departure and arrival times, airline and price.
What you get
- Flight options between two locations for specified dates (get_flight_offers)
- Results carrying departure time, arrival time, airline and price
- Origin, destination, ticket count and travel date taken as arguments, so a request phrased in plain language resolves into a real search
Requirements
Python with uv or pip, and Amadeus credentials: a client id and a client secret, obtained by creating an app on the Amadeus developer portal. This is an open-source project not affiliated with or endorsed by Amadeus IT Group.
Setup effort
Build from source — git clone https://github.com/donghyun-chae/mcp-amadeus.git
USE CASES
01
Pricing a trip you are still deciding about
Say where from, where to, when and for how many people, and the offers come back with times, carrier and price attached, so the conversation about whether to go has the numbers in it.
02
Comparing a few candidate dates
Run the same route for each date you are considering and let the assistant lay the prices out. Because the search is live, the comparison is against what is actually on sale.
03
Finding out whether a nonstop exists at all
Search the route and read what comes back before committing to a plan: departure and arrival times make it obvious whether the itinerary is direct or involves a change you did not want.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation. It searches and prices flights through the Flight Offers Search API; it cannot book, hold or cancel.
Requires
- AMADEUS_CLIENT_ID in your environment
- AMADEUS_CLIENT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/donghyun-chae/mcp-amadeus.git
cd mcp-amadeus
uv sync
cp .env.example .envEdit .env and set AMADEUS_CLIENT_ID and AMADEUS_CLIENT_SECRET (sign up at developers.amadeus.com and create an app to obtain them) — this must happen before the client launches the server, since the config block passes --env-file
Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add the mcpServers block below: <YOUR_PATH_TO_UV> is where uv is installed (which uv prints it), and <YOUR_PATH_TO_PARENT_FOLDER> is the full path of the mcp-amadeus folder you cloned
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"amadeus": {
"command": "<YOUR_PATH_TO_UV>",
"args": [
"--directory",
"<YOUR_PATH_TO_PARENT_FOLDER>/src/",
"run",
"--env-file",
"<YOUR_PATH_TO_PARENT_FOLDER>/.env",
"server.py"
]
}
}
}
