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
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//<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
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