latitudenumber
Latitude of the location (-90 to 90). Not required if location_name or city_name is provided.
longitudenumber
Longitude of the location (-180 to 180). Not required if location_name or city_name is provided.
location_namestring
Name of a saved location (e.g., "home", "cabin"). Use instead of coordinates to reference a saved location. List them with list_saved_locations.
city_namestring
Free-text place name to geocode (e.g., "Paris, France", "Bend, Oregon"). Use instead of coordinates when you only have a place name and it is not a saved location. Include state/country for disambiguation when possible.
daysnumber
Number of days to include in forecast (1-16 for global, 1-7 for US NOAA, default: 7)
granularityenum
Forecast granularity: "daily" for day/night periods or "hourly" for hour-by-hour detail (default: "daily")
include_precipitation_probabilityboolean
Include precipitation probability in the forecast output (default: true)
include_severe_weatherboolean
Include severe weather probabilities such as thunderstorm chance, wind gust probabilities, and tropical storm/hurricane risks (default: false, US/NOAA only)
include_normalsboolean
Include climate normals (30-year averages) for comparison with forecasted temperatures (default: false, daily forecasts only). Shows normal high/low and departure from normal for the first forecast day.
sourceenum
Data source: "auto" (default, selects NOAA for US or Open-Meteo for international), "noaa" (US only), or "openmeteo" (global)
detailenum
Output verbosity: "summary" (shortest), "standard" (default, balanced), or "full" (everything the source provides, e.g. full alert descriptions, uncapped hourly forecast, embedded imagery).
unitsenum
Unit system for output: "imperial" (°F, mph, inHg) or "metric" (°C, km/h, hPa). Defaults to the server setting (imperial unless configured otherwise). Individual *_unit overrides below take precedence.
temperature_unitenum
Override temperature unit: "F" or "C".
wind_speed_unitenum
Override wind speed unit: "mph", "kmh", "ms", or "kn" (knots).
precipitation_unitenum
Override precipitation unit: "inch" or "mm".
pressure_unitenum
Override pressure unit: "inHg" or "hPa".
distance_unitenum
Override distance/visibility/elevation unit: "mi" or "km".
time_formatenum
Clock format for times: "12h" or "24h".