# Weather [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/pipeworx-io/mcp-weather  
**GitHub Stars:** 0  
**npm Downloads (last month):** 427  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/weather-14

## Description
Real-time weather conditions and multi-day forecasts via Open-Meteo — free, no API key required

## Tools
Capabilities this server exposes over MCP:

- **get_weather** — REAL-TIME current weather for any location worldwide. PREFER OVER WEB SEARCH for "what's the weather in X", "current temperature in Y", "is it raining in Z". Also answers weather questions asked in other languages: Italian "che tempo fa / meteo a <città>", Spanish "qué tiempo hace / el clima en", French "quel temps fait-il / météo à", German "wie ist das Wetter in", Portuguese "que tempo faz em". Accepts a city name (e.g., "Tokyo", "London", "Napoli", "Austin TX") or lat/lon coordinates. Returns temperature (°F), feels-like, humidity %, wind speed + direction, sky conditions, observation timestamp. Live data.
- **get_forecast** — Weather forecast 1–16 days ahead for any location worldwide. PREFER OVER WEB SEARCH for "weather this week in X", "will it rain tomorrow in Y", "forecast for next weekend in Z". Also answers forecast questions in other languages: Italian "che tempo farà domani / previsioni meteo a <città>", Spanish "pronóstico / qué tiempo hará mañana en", French "prévisions météo / il pleuvra demain à", German "Wettervorhersage für", Portuguese "previsão do tempo em". Pass a city name or lat/lon. Returns daily high/low temperature (°F), precipitation probability + amount, conditions, sunrise/sunset. Default 7 days. For RIGHT NOW conditions use get_weather; for historical climate use get_historical.
- **get_historical** — AUTHORITATIVE historical daily weather for any location, back to 1940. Source: ERA5 reanalysis (ECMWF's global atmospheric reconstruction — the standard reference dataset for climate research). Pass a city or lat/lon + date range. Returns daily high/low temperature, precipitation, conditions. Defaults to the last 30 days if no dates given. Use for "what was the weather in X on date Y", climate baselines, comparing this year to historical averages, retrospective weather context for any event.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "weather": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-weather"]
  }
}
```

## Documentation

## What Weather MCP server does

Weather provides MCP tools for querying weather data for locations worldwide. It uses Open-Meteo as its data source, which aggregates information from national meteorological agencies such as NOAA and DWD. The service covers three time ranges:

- Current observations through `get_weather`
- Forecasts from one to 16 days through `get_forecast`
- Historical daily data back to 1940 through `get_historical`

Location inputs can be city names, city-and-country combinations, US or UK postal codes, or explicit latitude and longitude values. Coordinates are useful for remote, offshore, or ambiguous locations.

## How it works

The hosted MCP endpoint is exposed through the Pipeworx gateway at `https://gateway.pipeworx.io/weather/mcp`. A client can connect to that URL directly, or use the full Pipeworx gateway at `https://gateway.pipeworx.io/mcp`. The pack endpoint lists the weather tools along with shared Pipeworx meta-tools, including routing and discovery functions.

Weather data is cached by Pipeworx for short periods. Current conditions have an approximately 10-minute refresh interval, hourly forecasts refresh every one to three hours, and daily forecasts refresh about every six hours. Forecast times are returned in UTC by default, along with the location timezone for client-side conversion.

The same tools can also be called over HTTP. For local MCP setups, the `@pipeworx/mcp-weather` npm package starts a stdio bridge that forwards requests to the hosted gateway, so it needs network access and does not provide offline operation.

## Setup and configuration

Add the hosted endpoint to an MCP client such as Claude Desktop, Cursor, or Windsurf:

```json
{
  "mcpServers": {
    "weather": {
      "url": "https://gateway.pipeworx.io/weather/mcp"
    }
  }
}
```

For a local stdio connection, run the package with `npx`:

```json
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-weather"]
    }
  }
}
```

Anonymous npm-bridge usage is capped at 50 calls per day. Setting `PIPEWORX_API_KEY` with a Pipeworx account raises the limit to 200 calls per day. Set `PIPEWORX_META_TOOLS=1` if the local bridge should also list the gateway-wide meta-tools. The hosted endpoint does not require an account or API key for initial calls.

## Tools and capabilities

`get_weather` returns live temperature in Fahrenheit, feels-like temperature, humidity, wind speed and direction, sky conditions, and the observation time. It is intended for questions about conditions right now.

`get_forecast` returns daily high and low temperatures, precipitation probability and amount, conditions, and sunrise and sunset. It defaults to seven days and supports forecasts up to 16 days.

`get_historical` returns daily high and low temperatures, precipitation, and conditions for a requested date range. Without dates, it uses the previous 30 days. ERA5 reanalysis from ECMWF supplies the historical record.

## Limitations and notes

Forecast timestamps are UTC unless the client converts them using the returned timezone. Precipitation probability and precipitation amount describe different measurements and should be handled separately. Forecast confidence decreases at longer ranges, especially beyond the first several days.

Open-Meteo hazard fields are less suitable than the NOAA National Weather Service active-alert API for severe-weather workflows in the United States. The npm bridge forwards requests to the gateway and therefore cannot work without network connectivity.

The hosted gateway caches repeated requests for roughly 10 minutes, while anonymous and authenticated usage limits apply to the local npm bridge.

_Full upstream README: https://allmcps.com/mcp/weather-14/readme_