MadhurToshniwal/OpenWeather-MCP-server

OpenWeather MCP Server

A Model Context Protocol (MCP) server that integrates OpenWeather API with Claude, enabling real-time weather information, forecasts, and air quality data directly in your conversations.

Features

• 🌤️ Current Weather: Get real-time weather conditions for any city
• 📅 5-Day Forecast: Detailed weather forecasts with 3-hour intervals
• 📍 Coordinate-Based Search: Get weather data using latitude and longitude
• 🌍 Air Quality Index: Check pollution levels and air quality data
• 🌡️ Detailed Metrics: Temperature, humidity, wind speed, visibility, and more

Prerequisites

• Node.js v18 or higher
• Claude Desktop
• OpenWeather API key (free tier available)

Installation

1. Get OpenWeather API Key

1. Sign up at OpenWeather
2. Navigate to "My API keys" in your account
3. Copy your API key (note: new keys take ~2 hours to activate)

2. Clone and Setup

# Clone the repository
git clone https://github.com/MadhurToshniwal/OpenWeather-MCP-server.git
cd OpenWeather-MCP-server

# Install dependencies
npm install

# Build the project
npm run build

3. Configure Claude Desktop

Edit your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "openweather": {
      "command": "node",
      "args": [
        "/absolute/path/to/openweather-mcp-server/dist/index.js"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Important for Windows users: Use double backslashes in paths:

"args": ["C:\\Users\\YourName\\Desktop\\openweather-mcp-server\\dist\\index.js"]

4. Restart Claude Desktop

Completely quit and restart Claude Desktop for changes to take effect.

Usage Examples

Once configured, you can ask Claude:

• "What's the weather in Tokyo?"
• "Give me a 5-day forecast for London"
• "What's the weather at coordinates 40.7128, -74.0060?"
• "Check the air quality in Beijing"
• "Compare weather between Mumbai and Delhi"

Available Tools

get_current_weather

Get current weather conditions for a specific city.

Parameters:

• city (required): City name
• country_code (optional): 2-letter country code (e.g., "US", "GB")

get_forecast

Get 5-day weather forecast with 3-hour intervals.

Parameters:

• city (required): City name
• country_code (optional): 2-letter country code

get_weather_by_coordinates

Get current weather by geographic coordinates.

Parameters:

• latitude (required): Latitude coordinate
• longitude (required): Longitude coordinate

get_air_pollution

Get air quality data for specific coordinates.

Parameters:

• latitude (required): Latitude coordinate
• longitude (required): Longitude coordinate

API Limits

The free tier of OpenWeather API includes:

• 1,000 API calls per day
• 60 calls per minute
• Current weather data
• 5-day forecast
• Air pollution data

Project Structure

openweather-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript (generated)
├── .env                  # Environment variables (not in repo)
├── package.json
├── tsconfig.json
└── README.md

Development

# Build the project
npm run build

# Run in development mode
npm start

Technologies Used

• TypeScript: Type-safe development
• Model Context Protocol (MCP): Claude integration standard
• OpenWeather API: Weather data provider
• Axios: HTTP client for API requests

Troubleshooting

"API key not valid"

• Ensure your API key is correctly set in the configuration
• New API keys take up to 2 hours to activate after signup

Tools not appearing in Claude

• Verify the path in claude_desktop_config.json is correct
• Restart Claude Desktop completely
• Check that the project is built (dist folder exists)

"Cannot find module"

• Run npm install to install dependencies
• Ensure Node.js version is 18 or higher

License

MIT

Author

Madhur Toshniwal
📧 madhurtoshniwal03@gmail.com

Acknowledgments

• OpenWeather API for weather data
• Anthropic for the Model Context Protocol
• Claude Desktop for AI integration

Built for campus placement showcase | Demonstrates API integration, TypeScript, and modern development practices