OpenWeatherMap

Provides comprehensive weather data and forecasts using the OpenWeatherMap API.

A Model Context Protocol (MCP) server that provides comprehensive weather data and forecasts through the OpenWeatherMap API. This server enables AI assistants to access real-time weather information, forecasts, air quality data, and location services.

- Current Weather- Get current conditions for any location
- Weather Forecast- 5-day weather forecast with 3-hour intervals
- Hourly Forecast- Detailed hourly forecasts for up to 48 hours
- Daily Forecast- Daily weather forecasts for up to 8 days with temperature ranges and astronomical data
- Minutely Forecast- Minute-by-minute precipitation forecasts for the next hour
- Weather Alerts- Active weather warnings and alerts with severity classification

- Current Air Pollution- Real-time air quality index and pollutant measurements
- Location Info- Reverse geocoding to get location details from coordinates
- OneCall Weather- Comprehensive weather data combining multiple forecasts
- Air Pollution- Historical and forecast air quality data
- Geocoding- Convert location names to coordinates

- Bunruntime
- OpenWeatherMap API key (free atopenweathermap.org)

git clone https://github.com/robertn702/mcp-openweathermap.git cd mcp-openweathermap

cp .env.example .env # Edit .env and add your OpenWeatherMap API key

MCP_TRANSPORT=httpStream PORT=3000 bun run src/main.ts

{ "mcpServers": { "openweathermap": { "command": "npx", "args": ["mcp-openweathermap"], "env": { "OPENWEATHER_API_KEY": "your-api-key-here" } } } }

- get-current-weather- Current weather conditions
- get-weather-forecast- 5-day forecast
- get-hourly-forecast- Hourly forecasts (up to 48 hours)
- get-daily-forecast- Daily forecasts (up to 8 days)
- get-minutely-forecast- Minute-by-minute precipitation

- get-weather-alerts- Weather warnings and alerts
- get-current-air-pollution- Current air quality data
- get-air-pollution- Air quality forecasts and history

- get-location-info- Reverse geocoding from coordinates
- geocode-location- Convert addresses to coordinates
- get-onecall-weather- Comprehensive weather data

Then connect the MCP Inspector to test the tools interactively.

Stdio Transport:RequiresOPENWEATHER_API_KEYenvironment variable.

HTTP Transport:The OpenWeatherMap API key is passed as a bearer token in the HTTP request headers. No environment variable needed.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

This project is licensed under the MIT License - see theLICENSEfile for details.

- OpenWeatherMap API Documentation
- openweather-api-node Library- The underlying API client
- Model Context Protocol Documentation
- Issue Tracker

Provides weather information using the free and open-source Open-Meteo API. No API key required.