nws-weather-mcp-server — Claude Code MCP server: setup guide
nws-weather-mcp-server is a Claude Code MCP server for US weather forecasts, hazard alerts, and station observations via the National Weather Service API, without an API key.
Apache-2.0 1,326 installs ★ 2 updated 2026-10-23
claude mcp add --transport http nws-weather-mcp-server https://nws-weather-mcp-server--cyanheads.run.toolsWhat nws-weather-mcp-server does
This server supplies assistants with official National Weather Service reports across all 50 US states and territories. It provides access to 7-day and hourly temperature projections, active danger bulletins, and local forecaster narrative logs.
Tools handle coordinate grid conversions automatically so the model gets immediate forecast periods. Alert searches support fine-grained filtering by area, emergency event name, and severity levels, alongside historical station reads spanning roughly seven days.
Coordinates outside the United States or offshore marine locations trigger explicit error codes, so the integration cannot serve global locations.
What it helps with
- Fetch hourly or 7-day weather forecasts using latitude and longitude
- Filter active weather alerts and storm warnings across US regions
- Retrieve historical observation records from local weather stations
- Read narrative meteorological discussions directly from regional forecast offices
Example prompts for the agent
- Check for active severe weather warnings across Florida.
- Get the hourly weather forecast for coordinates 37.7749, -122.4194.
- Find weather stations near coordinates 40.7128, -74.0060 and show recent observations.
How to install nws-weather-mcp-server
Platform CLI: remote server
claude mcp add --transport http nws-weather-mcp-server https://nws-weather-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add nws-weather-mcp-server --url https://nws-weather-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"nws-weather-mcp-server": {
"url": "https://nws-weather-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"nws-weather-mcp-server": {
"type": "http",
"url": "https://nws-weather-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http nws-weather-mcp-server https://nws-weather-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about nws-weather-mcp-server
How do I install nws-weather-mcp-server in Claude Code?
Run claude mcp add --transport http nws-weather-mcp-server https://nws-weather-mcp-server--cyanheads.run.tools.
Is an API key required to run nws-weather-mcp-server?
No API key is needed because the National Weather Service provides open public endpoints.
Does nws-weather-mcp-server support locations outside the United States?
Coverage is strictly limited to the 50 US states and US territories; unsupported coordinates return a no_forecast_grid error.