Skip to content
MCP server

Qweather MCP

MCP server giving AI clients current weather, forecasts, warnings and air quality

Runs locally
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
1.0.12
Listing updated
today

Similar MCP servers

About Qweather MCP

Qweather MCP is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

The README describes this as a Model Context Protocol server that wraps the QWeather weather API, so AI assistants can ask for conditions and forecasts for a location through standard MCP tool calls. It runs over stdio and is typically launched with npx, with the package also listed for one-click install through Smithery.

The server exposes separate tools for current conditions, 3 to 30 day forecasts, minute-by-minute precipitation for the next two hours, hourly forecasts, weather warnings, life indices, and air quality now, hourly and daily. Authentication can use either QWeather's Ed25519 JWT flow, which the README recommends, or the older API key method, and the server picks a mode based on which environment variables are set.

It suits developers who want weather data inside a chat assistant or agent workflow and already hold a QWeather account and credentials.

Install

Run in a terminal

claude mcp add qweather-mcp --env QWEATHER_API_BASE='<QWEATHER_API_BASE>' --env QWEATHER_API_KEY='<QWEATHER_API_KEY>' -- npx -y qweather-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<QWEATHER_API_BASE>",
        "QWEATHER_API_KEY": "<QWEATHER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<QWEATHER_API_BASE>",
        "QWEATHER_API_KEY": "<QWEATHER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "qweather-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<QWEATHER_API_BASE>",
        "QWEATHER_API_KEY": "<QWEATHER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<QWEATHER_API_BASE>",
        "QWEATHER_API_KEY": "<QWEATHER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<QWEATHER_API_BASE>",
        "QWEATHER_API_KEY": "<QWEATHER_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • QWEATHER_API_BASEYour qweather api hostRequired
  • QWEATHER_API_KEYYour qweather api keyRequired

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

get-weather-now
Get current weather information for a specified location.
get-weather-forecast
Get weather forecast information for a specified location with customizable forecast days.
get-minutely-precipitation
Minute-by-minute precipitation forecast for the next 2 hours.
get-hourly-forecast
Hourly weather forecasts for 24, 72, or 168 hours.
get-weather-warning
Real-time weather warning information.
get-weather-indices
Weather life indices such as sports, car wash, dressing and fishing.
get-air-quality
Real-time air quality data including AQI and pollutant concentrations.
get-air-quality-hourly
Hourly air quality forecast for the next 24 hours.
get-air-quality-daily
Air quality forecast for the next 3 days.

What it does

Current weather lookup
Returns real-time conditions for a named or specified location.
Multi-day forecasts
Offers 3, 7, 10, 15 or 30 day forecast options with temperature, precipitation, wind and UV details.
Minute-level rain outlook
Gives a precipitation forecast for the next two hours, minute by minute.
Air quality data
Provides current AQI, pollutants and health advice, plus hourly and three-day forecasts.
Dual authentication modes
Supports JWT with EdDSA/Ed25519 keys as well as legacy API keys, selected from environment variables.
Custom API base
Lets the API host be configured to match a user's QWeather endpoint.

Good for

  • Letting an AI assistant answer questions about today's or next week's weather
  • Checking whether rain is due in the next couple of hours before planning an outdoor task
  • Adding air quality and health guidance to an agent's daily briefing
  • Pulling weather warnings for a set of locations into an automated workflow

Pricing

Open source

MIT-licensed server; QWeather API access requires a QWeather account and credentials.

Qweather MCP FAQ

Do I need an account to use it?

Yes. The README says you must obtain credentials from the QWeather Console and set either JWT variables or an API key.

Which transport does it use?

It runs as a stdio server, started with npx -y qweather-mcp according to the README.

What is the license?

The README lists the license as MIT.

Which authentication method is recommended?

The README recommends JWT with EdDSA and Ed25519, noting that API key authentication is expected to be deprecated in 2027.

Is Qweather MCP free?

Yes. Qweather MCP is open source, so you can use and self-host it for free.

How do I add Qweather MCP to Claude Code?

Run this command in your terminal: claude mcp add qweather-mcp --env QWEATHER_API_BASE='<QWEATHER_API_BASE>' --env QWEATHER_API_KEY='<QWEATHER_API_KEY>' -- npx -y qweather-mcp

What are the best alternatives to Qweather MCP?

The closest alternatives to Qweather MCP are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and acrawl.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers