How to add MCP Weather Server to Windsurf

Hourly and daily weather forecasts for LLMs via the AccuWeather API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 32★ · stdio · apikey

Windsurf config for MCP Weather Server

npx -y @timlukahorstmann/mcp-weather

{
  "mcpServers": {
    "mcp-weather-server": {
      "command": "npx",
      "args": [
        "-y",
        "@timlukahorstmann/mcp-weather"
      ],
      "env": {
        "ACCUWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the MCP Weather Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5MCP Weather Server's tools become available to Cascade.

Before you start

Node.js >= 18
An AccuWeather API key (free tier available, set via ACCUWEATHER_API_KEY)

What MCP Weather Server can do in Windsurf

weather-get_hourly

Provides hourly weather forecasts for the next 12 hours. Parameters: location (required, city or location name); units (optional, 'metric' for Celsius (default) or 'imperial' for Fahrenheit).

weather-get_daily

Provides daily weather forecasts for up to 15 days. Parameters: location (required, city or location name); days (optional, number of forecast days — 1, 5, 10, or 15; default 5); units (optional, 'metric' for Celsius (default) or 'imperial' for Fahrenheit).

Security

Requires an AccuWeather API key supplied via the ACCUWEATHER_API_KEY environment variable (free tier available). Keep your API key private and do not commit it to source control.

MCP Weather Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the MCP Weather Server config there under the "mcpServers" key and restart the client.

Is MCP Weather Server safe to use with Windsurf?

Requires an AccuWeather API key supplied via the ACCUWEATHER_API_KEY environment variable (free tier available). Keep your API key private and do not commit it to source control.

Do I need an API key?

Yes. You need an AccuWeather API key, which has a free tier. Sign up at developer.accuweather.com, create an app to get your key, and provide it via the ACCUWEATHER_API_KEY environment variable.

How far ahead can it forecast?

Hourly forecasts cover the next 12 hours, and daily forecasts cover up to 15 days (selectable as 1, 5, 10, or 15 days).

Can I access it over HTTP instead of stdio?

Yes. The README shows how to expose it over HTTP/REST (SSE) using supergateway, wrapping the stdio server and serving it on a configurable port.

View repo Full MCP Weather Server page