Weather Mcp

Weather MCP Server

[](https://www.npmjs.com/package/@dangahagan/weather-mcp) [](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.dgahagan/weather-mcp) [](https://opensource.org/licenses/MIT)

An MCP (Model Context Protocol) server that provides global weather data to AI systems like Claude Code. Uses NOAA's API for detailed US weather, plus Open-Meteo for international forecasts and historical weather data worldwide.

📦 Available in the Official MCP Registry as io.github.dgahagan/weather-mcp

No API keys required! All APIs (NOAA, Open-Meteo) are free to use with no authentication needed.

Features

• Global Weather Forecasts: Get forecasts for any location worldwide (ENHANCED in v0.4.0)
• Automatic source selection: NOAA (US, more detailed) or Open-Meteo (international)
• Extended forecasts up to 16 days (was 7)
• Sunrise/sunset times with daylight duration
• Daily or hourly granularity
• Precipitation probability display
• Temperature trends, humidity, wind, and UV index
• Current Conditions: Get enhanced real-time weather observations for US locations
• Heat index and wind chill when relevant
• 24-hour temperature range
• Wind gusts and detailed cloud cover
• Recent precipitation history
• Optional fire weather indices (see below)
• Location Search: Find coordinates for any location worldwide (v0.4.0)
• Convert location names to coordinates ("Paris" → 48.8534°, 2.3488°)
• Support for cities, airports, landmarks, and regions globally
• Detailed metadata: timezone, elevation, population, country
• Enables natural language queries: "What's the weather in Tokyo?"
• Saved Locations: Save and reuse favorite locations (NEW in v1.7.0)
• Save frequently used locations with simple aliases ("home", "work", "cabin")
• Use saved locations by name instead of coordinates in all weather tools
• Tag locations with activities ("boating", "hiking", "skiing") for contextual weather info
• Automatic geocoding when saving (just provide location name)
• Persistent storage in ~/.weather-mcp/locations.json
• Manage locations: save, list, view details, remove
• Makes queries natural: "What's the weather at home?" instead of providing coordinates
• Climate Normals - Historical Context: Compare weather to 30-year averages (NEW in v1.2.0)
• Optional enhancement for current conditions and forecasts (include_normals=true)
• Shows normal high/low temperatures and precipitation for comparison
• Displays departure from normal ("10°F warmer than normal")
• Hybrid data strategy: Open-Meteo computed normals (global, free) or optional NOAA NCEI official normals (US only, requires free API token)
• Based on 1991-2020 climate normals period
• Helps understand if weather is unusual for the time of year
• Snow and Ice Data: Enhanced winter weather information (NEW in v1.2.0)
• Snow depth on ground (current conditions, US only)
• Snowfall accumulation forecasts with time periods
• Ice accumulation forecasts for freezing rain events
• Smart threshold-based display (filters trace amounts)
• Unit conversions from metric to imperial
• Timezone-Aware Display: All timestamps in local time (NEW in v1.2.0)
• Automatic timezone detection from coordinates
• All times displayed in location's local timezone
• Includes timezone abbreviations (EST, PDT, etc.)
• Handles daylight saving time transitions
• Formatted time ranges for forecast periods
• Weather Alerts: Get active weather watches, warnings, and advisories for US locations
• Severity levels (Extreme, Severe, Moderate, Minor)
• Urgency and certainty indicators
• Effective and expiration times
• Instructions and recommended responses
• Historical Data: Access historical weather observations for any location worldwide
• Recent data (last 7 days): Detailed hourly observations from NOAA real-time API (US only)
• Archival data (>7 days old): Hourly/daily weather data from 1940-present via Open-Meteo (global coverage)
• Air Quality Monitoring: Comprehensive air quality data for any location worldwide (v0.5.0)
• Air Quality Index (AQI) with automatic region detection (US AQI or European EAQI)
• Health recommendations based on AQI levels
• Pollutant concentrations (PM2.5, PM10, O₃, NO₂, SO₂, CO, NH₃)
• UV Index with sun protection recommendations
• Optional hourly air quality forecasts (5-day outlook)
• Categorized health risk levels (Good, Moderate, Unhealthy, etc.)
• Activity recommendations for sensitive populations
• Severe Weather Probabilities: Probabilistic severe weather forecasting (NEW in v0.6.0)
• US locations only (NOAA gridpoint data)
• Optional enhancement to forecasts (include_severe_weather parameter)
• Thunderstorm probability for next 48 hours
• Wind gust probabilities (20-60+ mph categories)
• Tropical storm and hurricane wind probabilities
• Lightning activity levels
• Smart display showing only significant threats
• Works with both daily and hourly forecasts
• Fire Weather Data: Fire danger indices for US locations (v0.5.0)
• Haines Index (atmospheric fire growth potential)
• Grassland Fire Danger Index
• Red Flag Threat Index
• Mixing Height (smoke dispersion indicator)
• Transport Wind Speed (smoke transport)
• Optional enhancement to current conditions
• Marine Conditions: Comprehensive marine weather for coastal and ocean areas (NEW in v0.6.0)
• Global coverage for waves, swell, and ocean currents
• Significant wave height with safety categorization (Calm to Extreme)
• Wind waves (locally generated) and swell (distant systems) separation
• Wave period and direction for planning
• Ocean current velocity and direction
• Optional 5-day marine forecast with daily summaries
• Safety assessment for maritime activities (sailing, boating, surfing)
• Wave interpretation guide based on Douglas Sea Scale
• Important: Data has limited coastal accuracy - NOT for navigation
• Weather Imagery: Visual weather radar and precipitation maps (NEW in v1.5.0)
• Global precipitation radar from RainViewer API
• Static radar images showing current precipitation
• Animated radar loops (up to 2 hours of history)
• Tile URLs for efficient rendering
• Automatic coordinate-to-tile calculation
• Visual confirmation of approaching weather
• Free, no API key required
• Lightning Activity: Real-time lightning strike detection and safety monitoring (NEW in v1.5.0)
• Real-time strike detection from Blitzortung.org network
• Strikes within customizable radius (default: 100km)
• 4-level safety assessment (Safe, Elevated, High, Extreme)
• Distance to nearest strike with comprehensive statistics
• Strike polarity and amplitude information
• Safety recommendations based on proximity
• Critical for outdoor activity safety planning
• Free, no API key required
• River Conditions: Monitor river levels and flood status for safety and recreation (NEW in v1.6.0)
• Current water levels from NOAA and USGS gauges
• Flood stage thresholds (action, minor, moderate, major)
• Streamflow data in cubic feet per second
• Distance-based gauge filtering within customizable radius
• Safety assessment for boating and recreation
• Historical flood crest data when available
• US coverage via NOAA NWPS and USGS Water Services
• Wildfire Information: Track active wildfires and fire perimeters (NEW in v1.6.0)
• Active wildfire locations and prescribed burns
• Fire size, containment status, and discovery date
• Distance-based proximity filtering
• 4-level safety assessment (Extreme Danger, High Alert, Caution, Awareness)
• Evacuation recommendations based on proximity
• Detailed fire attributes (type, location, status)
• Data from NIFC WFIGS (National Interagency Fire Center)
• Service Status Checking: Proactively verify API availability with health checks
• Enhanced Error Handling: Detailed, actionable error messages with status page links
• Intelligent Caching: Built-in in-memory cache reduces API calls and improves performance

Caching

The Weather MCP server includes an intelligent in-memory caching system that significantly improves performance for AI-driven weather queries.

Benefits

• Faster Responses: Cached queries return in 1 day old)**: Cached indefinitely (finalized data never changes)
• **Recent Historical (50km): No immediate lightning threat
• Elevated (16-50km): Monitor conditions, plan indoor access
• High (8-16km): Seek shelter immediately
• Extreme (50km): Stay informed
• Evacuation recommendations and safety guidance

Note: Data from NIFC WFIGS (Wildland Fire Interagency Geospatial Services). Always consult official sources for evacuation orders at https://inciweb.nwcg.gov/

13. save_location (NEW in v1.7.0)

Save a location with an alias for easy reuse in weather queries.

Parameters:

• alias (required): Short name for the location (e.g., "home", "work", "cabin"). Max 50 characters.
• location_query (optional): Location to geocode and save (e.g., "Seattle, WA", "Paris, France"). Not required if latitude/longitude provided.
• latitude (optional): Latitude if providing coordinates directly. Not required if location_query provided.
• longitude (optional): Longitude if providing coordinates directly. Not required if location_query provided.
• name (optional): Display name (required when using latitude/longitude directly)
• activities (optional): Activities you do at this location (e.g., ["boating", "fishing"]). Helps AI provide relevant weather information. Each activity max 50 characters.

Description: Saves a location to persistent storage (~/.weather-mcp/locations.json) for easy reuse. Accepts either a location query (which will be automatically geocoded using Nominatim/OpenStreetMap) or direct coordinates. Once saved, the location can be used in any weather tool by providing location_name instead of coordinates.

Smart Updates: If the alias already exists and you only provide name and/or activities (without location details), it will update just those fields while preserving all coordinates and metadata. This makes it easy to add activities or rename locations without re-specifying the full address.

Examples:

"Save my home location in Seattle, WA"
  → save_location(alias="home", location_query="Seattle, WA")

"Save the cabin at Lake Tahoe"
  → save_location(alias="cabin", location_query="Lake Tahoe, CA")

"Save coordinates 47.6062, -122.3321 as my office"
  → save_location(alias="office", latitude=47.6062, longitude=-122.3321, name="Seattle Office")

"Save the lake house where we go boating and fishing"
  → save_location(alias="lake_house", location_query="Lake Tahoe, CA", activities=["boating", "fishing"])

"Save my favorite hiking spot"
  → save_location(alias="trail", location_query="Mt. Rainier, WA", activities=["hiking", "camping", "photography"])

"Add more activities to the cabin" (smart update - no location needed)
  → save_location(alias="cabin", activities=["boating", "fishing", "hiking", "swimming"])

"Rename my campsite" (smart update - no location needed)
  → save_location(alias="campsite", name="Yosemite Valley Campground")

Returns:

• Confirmation of save with location details
• Coordinates, timezone, and administrative region
• Usage examples showing how to use with weather tools

14. listsavedlocations (NEW in v1.7.0)

View all saved locations.

Parameters: None

Description: Lists all locations saved in your persistent storage with their aliases, names, coordinates, and save dates. Helpful for seeing what location names are available for use with weather tools.

Examples:

"Show my saved locations"
"What locations do I have saved?"
"List all my saved places"

Returns:

• List of all saved locations with full details
• Usage examples for each location
• Total count of saved locations

15. getsavedlocation (NEW in v1.7.0)

Get details for a specific saved location.

Parameters:

• alias (required): The name of the saved location to retrieve (e.g., "home", "work")

Description: Retrieves detailed information about a specific saved location, including coordinates, timezone, region information, and save/update timestamps.

Examples:

"Show details for my home location"
"What are the coordinates for my cabin?"
"Get info about my work location"

Returns:

• Location name and coordinates
• Timezone and administrative regions
• Save and update timestamps
• Usage examples

16. removesavedlocation (NEW in v1.7.0)

Remove a saved location.

Parameters:

• alias (required): The name of the saved location to remove (e.g., "home", "work")

Description: Permanently removes a saved location from storage. The location data is deleted and can no longer be used with weather tools unless saved again.

Examples:

"Remove my work location"
"Delete the cabin from saved locations"
"Remove home"

Returns:

• Confirmation of removal
• Count of remaining saved locations

Using Saved Locations with Weather Tools

Once you've saved locations, you can use them with any weather tool by providing location_name instead of coordinates:

Examples:

# Instead of:
get_forecast(latitude=47.6062, longitude=-122.3321)

# You can use:
get_forecast(location_name="home")

# Natural language queries work too:
"What's the weather forecast at home?"
"How's the air quality at my cabin?"
"Are there any weather alerts for my work location?"

Currently Supported Tools:

• get_forecast - Weather forecasts using saved locations

Coming Soon: Support for saved locations in all weather tools (current conditions, alerts, air quality, marine conditions, etc.)

Error Handling & Service Status

Enhanced Error Messages

This MCP server provides detailed, actionable error messages when issues occur. All error messages include:

• Clear problem description - What went wrong and why
• Contextual help - Specific guidance based on the error type
• Status page links - Direct links to official service status pages
• Recommended actions - Concrete steps to resolve or investigate the issue

Example Error Messages:

When a service is down:

NOAA API server error: Service temporarily unavailable

The NOAA Weather API may be experiencing an outage.

Check service status:
- Planned outages: https://weather-gov.github.io/api/planned-outages
- Service notices: https://www.weather.gov/notification
- Report issues: nco.ops@noaa.gov or (301) 683-1518

When rate limited:

Open-Meteo API rate limit exceeded (10,000 requests/day for non-commercial use).

Please retry later or consider:
- Reducing request frequency
- Using daily instead of hourly data for longer periods
- Upgrading to a commercial plan for higher limits

More info: https://open-meteo.com/en/pricing

Service Status Checking

Use the check_service_status tool to proactively verify API availability:

# Query example
"Check if the weather services are working"

# Returns:
- ✅/❌ Status for NOAA API (US forecasts & current conditions)
- ✅/❌ Status for Open-Meteo API (global historical data)
- Links to official status pages
- Recommended actions if issues detected
- Overall service availability summary

When to use:

• Before making multiple weather requests
• When experiencing errors or timeouts
• To verify service availability after an outage
• For monitoring and alerting purposes

Status Page Links:

• NOAA API:
• Planned outages: https://weather-gov.github.io/api/planned-outages
• Service notices: https://www.weather.gov/notification
• Report issues: https://weather-gov.github.io/api/reporting-issues

• Open-Meteo API:
• Pro

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: weather-mcp
• Source: weather-mcp/weather-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.