Find Flights MCP Server

by ravinahp

210 stars

626 downloads

Not rated

GitHub

Other

About

A read-only MCP server that searches and retrieves flight information using the Duffel API. It integrates with Claude Desktop to let users search for flights using natural language, supporting one-way, round-trip, and multi-city itineraries.

Details

Author: ravinahp
GitHub stars: 210
Downloads: 626
Categories: Other

- Search flights between multiple destinations
- Support for one-way, round-trip, and multi-city queries
- Detailed flight offer information (pricing, routes, connections)
- Flexible parameters (dates, cabin class, passenger count)
- Automatic handling of flight connections
- Multiple‑day search to find best prices

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Find Flights MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

From the repository

Install the server via Smithery or manually with uv sync. Configure it as an MCP server in your Claude Desktop configuration file (claude_desktop_config.json) by adding a flights-mcp entry with the command uv --directory /path/to/flights-mcp run flights-mcp and setting the DUFFEL_API_KEY_LIVE environment variable. Then ask Claude flight questions in natural language.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "find flights mcp server": {
            "flights-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@ravinahp/travel-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "flights-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@ravinahp/travel-mcp",
            "--client",
            "claude"
        ]
    }
}

Find Flights MCP Server

MCP server for searching and retrieving flight information using Duffel API.

How it Works

Video Demo

https://github.com/user-attachments/assets/c111aa4c-9559-4d74-a2f6-60e322c273d4

Why This is Helpful

While tools like Google Flights work great for simple trips, this tool shines when dealing with complex travel plans. Here's why:

- Contextual Memory: Claude remembers all your previous flight searches in the chat, so you don't need to keep multiple tabs open to compare prices
- Flexible Date Search: Easily search across multiple days to find the best prices without manually checking each date
- Complex Itineraries: Perfect for multi-city trips, one-stop flights, or when you need to compare different route options you can just ask!
- Natural Conversation: Just describe what you're looking for - no more clicking through calendar interfaces or juggling search parameters down to parsing city names, dates, and times.

Think of it as having a travel agent in your chat who remembers everything you've discussed and can instantly search across dates and routes.

Features

- Search for flights between multiple destinations - Support for one-way, round-trip, and multi-city flight queries - Detailed flight offer information - Flexible search parameters (departure times, cabin class, number of passengers) - Automatic handling of flight connections - Search for flights within multiple days to find the best flight for your trip (slower)

Prerequisites

- Python 3.x - Duffel API Live Key

Getting Your Duffel API Key

Duffel requires account verification and payment information setup, but this MCP server only uses the API for searching flights - no actual bookings or charges will be made to your account.

Try using duffel_test first to see the power of this tool. If you end up liking it, you can go through the verification process below to use the live key.

Test Mode First (Recommended)

You can start with a test API key (duffel_test) to try out the functionality with simulated data before going through the full verification process: 1. Visit Duffel's registration page 2. Create an account (you can select "Personal Use" for Company Name) 3. Navigate to More > Developer to find your test API key (one is already provided)

Getting a Live API Key

To access real flight data, follow these steps: 1. In the Duffel dashboard, toggle "Test Mode" off in the top left corner 2. The verification process requires multiple steps - you'll need to toggle test mode off repeatedly: - First toggle: Verify your email address - Toggle again: Complete company information (Personal Use is fine) - Toggle again: Add payment information (required by Duffel but NO CHARGES will be made by this MCP server) - Toggle again: Complete any remaining verification steps - Final toggle: Access live mode after clicking "Agree and Submit" 3. Once fully verified, go to More > Developer > Create Live Token 4. Copy your live API key

💡 TIP: Each time you complete a verification step, you'll need to toggle test mode off again to proceed to the next step. Keep toggling until you've completed all requirements.

⚠️ IMPORTANT NOTES:
- Your payment information is handled directly by Duffel and is not accessed or stored by the MCP server
- This MCP server is READ-ONLY - it can only search for flights, not book them
- No charges will be made to your payment method through this integration
- All sensitive information (including API keys) stays local to your machine
- You can start with the test API key (duffel_test) to evaluate the functionality
- The verification process may take some time - this is a standard Duffel requirement

Security Note

This MCP server only uses Duffel's search endpoints and cannot make bookings or charges. Your payment information is solely for Duffel's verification process and is never accessed by or shared with the MCP server.

Note on API Usage Limits

- Check Duffel's current pricing and usage limits - Different tiers available based on your requirements - Recommended to review current pricing on their website

Installation

Installing via Smithery

To install Find Flights for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ravinahp/travel-mcp --client claude

Manual Installation

Clone the repository:

git clone https://github.com/ravinahp/flights-mcp
cd flights-mcp

Install dependencies using uv:

uv sync

Note: We use uv instead of pip since the project uses pyproject.toml for dependency management.

Configure as MCP Server

To add this tool as an MCP server, modify your Claude desktop configuration file.

Configuration file locations:
- MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration to your JSON file:

{

    "flights-mcp": {

        "command": "uv",

        "args": [

            "--directory",

            "/Users/YOUR_USERNAME/Code/flights-mcp",

            "run",

            "flights-mcp"

        ],

        "env": {

            "DUFFEL_API_KEY_LIVE": "your_duffel_live_api_key_here"

        }

    }

}

⚠️ IMPORTANT:
- Replace YOUR_USERNAME with your actual system username
- Replace your_duffel_live_api_key_here with your actual Duffel Live API key
- Ensure the directory path matches your local installation

Deployment

Building

Prepare the package: ```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Find Flights MCP Server

How it Works

Video Demo

Why This is Helpful

Features

Prerequisites

Getting Your Duffel API Key

Test Mode First (Recommended)

Getting a Live API Key

Security Note

Note on API Usage Limits

Installation

Installing via Smithery

Manual Installation

Configure as MCP Server

Deployment

Building

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀