Amadeus MCP Server

What is Amadeus MCP Server about?

Enables MCP‑compatible clients (e.g., Claude Desktop) to retrieve flight offers between two locations on specified dates by invoking the Amadeus Flight Offers Search API. The server translates natural‑language requests into structured API calls and returns detailed flight options in JSON.

How to use Amadeus MCP Server?

Install the server (e.g., via Smithery):

npx -y @smithery/cli install @donghyun-chae/mcp-amadeus --client claude

Clone the repository and install dependencies with uv or pip.
Create a .env file from .env.example and add your Amadeus CLIENT_ID and CLIENT_SECRET.
Register the server in the MCP client configuration, pointing to the uv command that runs src/server.py with the .env file.
From the MCP client, call the exposed tool get_flight_offers with required parameters (origin, destination, departure_date, etc.).

Key Features

Flight Offers Search: Retrieves available flights, including times, airlines, and pricing.
Parameter Rich: Supports round‑trip, cabin class, non‑stop filter, currency, price limits, and passenger composition.
MCP Integration: Exposes a single tool (get_flight_offers) that can be invoked by any MCP‑compatible AI assistant.
Python SDK: Built on the official amadeus-python SDK for reliable API interaction.

Use Cases

Conversational travel assistants that can answer user queries like “Show me nonstop flights from NYC to London on June 15.”
Automated booking workflows where an AI agent gathers flight options before proceeding to reservation.
Prototyping travel‑related plugins for Claude Desktop or other LLM‑driven platforms.

FAQ

Q: Do I need an Amadeus developer account? A: Yes. Sign up at https://developers.amadeus.com/, create an app, and obtain a Client ID and Client Secret.

Q: Which environment variables are required? A: AMADEUS_CLIENT_ID and AMADEUS_CLIENT_SECRET must be set in the .env file.

Q: Can I use this server with other MCP clients? A: Absolutely. Any client that follows the Model Context Protocol can register the server and call get_flight_offers.

Q: How many flight offers can be returned? A: Up to 250 offers by default; you can limit the number with the max parameter.

Q: Is the project affiliated with Amadeus? A: No. It is an open‑source community project and is not endorsed by Amadeus IT Group.

MCP-Amadeus is a community-developed Model Context Protocol (MCP) server that integrates with the Amadeus Flight Offers Search API 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
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.

amadeus-mcp

🚀 Quick Start

Installing via Smithery

To install Amadeus MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @donghyun-chae/mcp-amadeus --client claude

1. Clone and Setup

git clone https://github.com/donghyun-chae/mcp-amadeus.git
cd mcp-amadeus-flight-offers

# Install dependencies (using uv or pip)
uv sync

2. Get Your API Key and Set Environment

cp .env.example .env

Then edit .env and add your API credentials:

AMADEUS_CLIENT_ID=your_client_id
AMADEUS_CLIENT_SECRET=your_client_secret

3. Configure MCP Client

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "amadeus": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
                "run",
                "--env-file",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
                "server.py"
            ]
        }
    }
}

Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/ with the actual path to your project folder.

my case:

{
    "mcpServers": {
        "amadeus": {
            "command": "/Users/asena/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/asena/mcp-amadeus/src/",
                "run",
                "--env-file",
                "/Users/asena/mcp-amadeus/.env",
                "server.py"
            ]
        }
    }
}

🛠️ Tools

After installation, the following tool is exposed to MCP clients:

`get_flight_offers`

Retrieves flight offers from the Amadeus Flight Offers Search API.

Request:

{
  "action": "tool",
  "name": "get_flight_offers",
  "params": {
  "origin": "JFK",
  "destination": "LHR",
  "departure_date": "2025-06-15"
  }
}

Parameters:

Name	Type	Required	Description	Example
origin	string	Yes	IATA code of departure city/airport	JFK
destination	string	Yes	IATA code of destination city/airport	LHR
departure_date	string	Yes	Departure date (YYYY-MM-DD)	2025-06-15
return_date	string	No	Return date (YYYY-MM-DD). One-way if omitted	2025-06-20
adults	integer	Yes	Number of adults (1-9). Default: 1	2
children	integer	No	Number of children (2-11). Max total: 9	1
infants	integer	No	Number of infants (≤2). Max: # of adults	1
travel_class	string	No	Cabin class: ECONOMY, BUSINESS, etc.	ECONOMY
non_stop	boolean	No	If true, only non-stop flights. Default: false	true
currency_code	string	No	Currency in ISO 4217 (e.g., USD)	EUR
max_price	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.

Amadeus MCP Server