flightradar24-mcp-server

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? ✨

• 🔍 Track any flight in real-time
• ⏰ Get arrival and departure times for specific flights
• 🌉 View the status of flights at an airport
• 🚨 Monitor emergency flights

Setup Guide 🚀

1. Prerequisites

• Claude Desktop installed on your computer
• A Flightradar24 API key (get one from Flightradar24's website)*

2. Installation

• Clone this repository somewhere on your computer:

  git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git
  

• Install dependencies & build the project:

  cd flightradar24-mcp-server
  npm install
  npm run build
  

3. Integration with Claude Desktop

• Open your Claude Desktop configuration file:

  # On Mac:
  ~/Library/Application Support/Claude/claude_desktop_config.json
  
  # On Windows:
  %APPDATA%/Claude/claude_desktop_config.json
  

• 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"
        }
      }
    }
  }
  

• 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

• Restart Claude Desktop for the changes to take effect

Environment Setup

• Copy .env.example to .env:

  cp .env.example .env
  

• 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:

• "What's the ETA for United Airlines flight UA123?"
• "Show me all flights currently at SFO"
• "Are there any emergency flights in the area?"
• "Show me all international flights arriving at SFO in the next 2 hours"
• "How many commercial flights are currently over the Pacific Ocean?"
• "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"

• Check if the path in claude_desktop_config.json is correct
• Make sure you're using the full absolute path
• Verify your API key is correct
• Try restarting Claude Desktop

"The server isn't responding"

• Make sure your Flightradar24 API key is valid
• Check if the API URL is correct
• Look for any error messages in server logs

FlightRadar API Access

• Note: Using Flightradar24's API requires a subscription

Need More Help? 🆘

• Make sure Claude Desktop is properly installed
• Verify your Flightradar24 API key is active
• Check the path in your configuration file is correct
• Look for error messages in MCP server logs

License 📄

MIT

Made with ❤️ for aviation enthusiasts