Amadeus MCP Server
MCP-Amadeus is a community-developed to provide flight search capabilities through natural language interfaces. Built for use with MCP-compatible clients (e.g., Claude Desktop).
This project enables users to easily search for flight options between two locations with specific dates using the power of large language models (LLMs) and the Amadeus API.
This project uses the official amadeus-python SDK
Disclaimer: This is an open-source project not affiliated with or endorsed by Amadeus IT Group. Amadeus® is a registered trademark of Amadeus IT Group.
✨ Features
✈️ Flight Offers Search
Retrieve flight options between two locations for specified dates.
"I'm looking for nonstop flights from New York to London on June 15th, any airline, for 1 adult."
→ ✈️ Returns available flight options with details like departure time, arrival time, airline, and price.
Powered by Amadeus Flight Offers Search API
Configurable test/production endpoints
Requires origin, destination, number of tickets and travel date input
🌐 Demo
Once installed and connected to an MCP-compatible client (e.g., Claude Desktop), this server exposes tools that your AI assistant can use to fetch flight data.
🚀 Quick Start
Installing via Smithery
To install Amadeus MCP Server for Claude Desktop automatically via Smithery:
1. Clone and Setup
2. Get Your API Key and Set Environment
Then edit .env and add your API credentials:
Configuration Options:
AMADEUS_CLIENT_ID: Your Amadeus API Client IDAMADEUS_CLIENT_SECRET: Your Amadeus API Client SecretAMADEUS_HOSTNAME: API endpoint to use -testfor testing (default) orproductionfor live API
Sign up on https://developers.amadeus.com/ and create an app to obtain your Client ID and Client Secret.
🌐 Environment Configuration
The server supports both test and production Amadeus API endpoints:
Test Environment (
AMADEUS_HOSTNAME=test): Use this for development and testing. The test environment provides:Free API access with test data
No charges for API requests
Limited to test flight data
Production Environment (
AMADEUS_HOSTNAME=production): Use this for live applications. The production environment provides:Real, live flight data
Pay-per-request pricing
Full access to all Amadeus services
⚠️ Important: Always use the test environment during development. Switch to production only when your application is ready for live data and you understand the associated costs.
3. Configure MCP Client
Register this server in your MCP client (e.g., Claude for Desktop).
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Replace
/ABSOLUTE/PATH/TO/PARENT/FOLDER/with the actual path to your project folder.
my case:
🛠️ Tools
After installation, the following tool is exposed to MCP clients:
search_flight_offers
Retrieves flight offers from the Amadeus Flight Offers Search API. The API endpoint (test/production) is configurable via the AMADEUS_HOSTNAME environment variable.
Request:
Parameters:
Name | Type | Required | Description | Example |
originLocationCode | string | Yes | IATA code of departure city/airport | JFK |
destinationLocationCode | string | Yes | IATA code of destination city/airport | LHR |
departureDate | string | Yes | Departure date (YYYY-MM-DD) | 2025-06-15 |
adults | integer | Yes | Number of adults (1-9). Default: 1 | 2 |
returnDate | string | No | Return date (YYYY-MM-DD). One-way if omitted | 2025-06-20 |
children | integer | No | Number of children (2-11). Max total: 9 | 1 |
infants | integer | No | Number of infants (≤2). Max: # of adults | 1 |
travelClass | string | No | Cabin class: ECONOMY, BUSINESS, etc. | ECONOMY |
nonStop | boolean | No | If true, only non-stop flights. Default: false | true |
currencyCode | string | No | Currency in ISO 4217 (e.g., USD) | EUR |
maxPrice | integer | No | Max price per traveler | 500 |
max | integer | No | Max number of offers. Default: 250 | 10 |
Output: Returns flight offers in JSON format with airline, times, duration, and pricing details from Amadeus.
📚 References
📝 License
MIT License © 2025 donghyun-chae
This server cannot be installed