Home

Awesome

Flightradar24 MCP Server 🛩ī¸

A Claude Desktop MCP server that helps you track flights in real-time using Flightradar24 data. Perfect for aviation enthusiasts, travel planners, or anyone curious about flights overhead!

What Can This Do? ✨

<img width="1466" alt="Anthropic Claude MCP Hackathon - FlightRadar24 MCP server" src="https://github.com/user-attachments/assets/719444ae-2c8b-4441-84f8-5150337d871f" />

Setup Guide 🚀

1. Prerequisites

2. Installation

  1. Clone this repository somewhere on your computer:

    git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git
    
  2. Install dependencies & build the project:

    cd flightradar24-mcp-server
    npm install
    npm run build
    

3. Integration with Claude Desktop

  1. Open your Claude Desktop configuration file:

    # On Mac:
    ~/Library/Application Support/Claude/claude_desktop_config.json
    
    # On Windows:
    %APPDATA%/Claude/claude_desktop_config.json
    
  2. Add the following to the mcpServers object in your config:

    {
      "mcpServers": {
        "flightradar24-server": {
          "command": "node",
          "args": [
            "/Users/<username>/<FULL_PATH...>/flightradar24-mcp-server/dist/index.js"
          ],
          "env": {
            "FR24_API_KEY": "your_api_key_here",
            "FR24_API_URL": "https://fr24api.flightradar24.com"
          }
        }
      }
    }
    
  3. Important Steps:

    • Replace /FULL/PATH/TO/flightradar24-mcp-server with the actual full path to where you cloned the repository
    • Add your Flightradar24 API key in the env section
    • Make sure to use forward slashes (/) in the path, even on Windows
  4. Restart Claude Desktop for the changes to take effect

Environment Setup

  1. Copy .env.example to .env:

    cp .env.example .env
    
  2. Update the .env file with your actual Flightradar24 API key:

    FR24_API_KEY=your_actual_api_key_here
    

Note: Never commit your actual API key to version control. The .env file is ignored by git for security reasons.

Let's Try It Out! 🎮

Once the server is configured, you can ask Claude questions like:

  1. "What's the ETA for United Airlines flight UA123?"
  2. "Show me all flights currently at SFO"
  3. "Are there any emergency flights in the area?"
  4. "Show me all international flights arriving at SFO in the next 2 hours"
  5. "How many commercial flights are currently over the Pacific Ocean?"
  6. "Identify any flights that have declared an emergency in the California region"

Example conversation with Claude:

You: What's the status of flight UA123?
Claude: Let me check that for you...
[Claude will use the MCP server to fetch real-time flight information]

Common Questions & Troubleshooting 🤔

"Claude can't connect to the server"

"The server isn't responding"


## Need More Help? 🆘

1. Make sure Claude Desktop is properly installed
2. Verify your Flightradar24 API key is active
3. Check the path in your configuration is absolute and correct
4. Look for error messages in Claude Desktop's logs

## License 📄

MIT - Feel free to use this however you want!

---

Made with ❤ī¸ for aviation enthusiasts