amadeus mcp server

this mcp server integrates amadeus flight search capabilities with claude desktop.

setup

1. environment variables required in .env:

amadeus_api_key=your_key
amadeus_api_secret=your_secret

2. claude desktop config:

{
  "mcpservers": {
    "amadeus": {
      "command": "python",
      "args": ["path/to/amadeus/server.py"],
      "env": {
        "amadeus_api_key": "your_key",
        "amadeus_api_secret": "your_secret",
        "pythonpath": "path/to/amadeus"
      }
    }
  }
}

available tools

search_flights

parameters:

• origin: iata airport code
• destination: iata airport code
• date: yyyy-mm-dd format

troubleshooting

common issues

1. connection timeouts

• check server.py logs in amadeus_mcp.log
• verify environment variables
• check claude desktop logs
• see mcp documentation for protocol details

2. authentication errors

• verify amadeus api credentials
• check .env file permissions
• ensure credentials are properly loaded

debugging steps

1. run standalone test:

npx @modelcontextprotocol/inspector python path/to/server.py

2. check logs:

tail -f amadeus_mcp.log

3. verify environment:

python -c "import os; print(os.getenv('amadeus_api_key'))"

architecture notes

• uses fastmcp for server implementation
• implements stdio transport
• logs to both stderr and file
• handles async flight search operations

support resources

1. model context protocol documentation
2. amadeus api documentation
3. claude desktop mcp guide