QWeather MCP server and CLI

Bring weather data into your MCP workflow without extra glue code.

qweather-mcp wraps QWeather APIs into clean MCP tools for current conditions, forecasts, alerts, air quality, and lifestyle indices.

Install now Browse tools
Coverage
Current, hourly, minutely, daily, air quality
Runtime
stdio MCP server and CLI
Config
API base and key via environment variables

Overview

Designed for agents that need weather context fast.

The page is organized around the two real tasks most users have: install the server quickly, then understand which tools are worth wiring into prompts, automations, or local workflows.

Current conditions

Temperature, feels-like, humidity, wind, and other essential real-time weather signals.

Forecast horizons

Mix minutely precipitation, hourly forecast, and long-range daily forecasts in one server.

Risk and decisions

Pull warnings, air quality, and lifestyle indices when the use case is more than “is it raining”.

Deployable shape

Runtime configuration stays minimal: API base plus API key, no extra bootstrap ceremony.

Install & Run

Two setup paths, one fast default.

Recommended

Install with Smithery

Best when you want the quickest MCP client integration with the least manual setup. 

npx -y @smithery/cli install @overstarry/qweather-mcp --client claude
Manual

Export env and start stdio

  1. Get an API key from the QWeather Console.
  2. Export the runtime environment variables.
  3. Start the stdio server from Node.js.
export QWEATHER_API_BASE=https://api.qweather.com
export QWEATHER_API_KEY=<your-api-key>

# start stdio server
npx -y qweather-mcp

Tooling Surface

Grouped by the questions an agent actually asks.

Current weather

  • get-weather-now for current conditions
  • Fast access to temperature, feels-like, wind, humidity, and visibility

Forecasts

  • get-weather-forecast for 3 / 7 / 10 / 15 / 30-day forecasts
  • get-hourly-forecast for 24 / 72 / 168-hour forecasts
  • get-minutely-precipitation for the next 2 hours

Decision support

  • get-weather-indices for lifestyle indices
  • get-weather-warning for severe weather awareness

Air quality

  • get-air-quality for real-time air quality
  • get-air-quality-hourly for hourly AQI trends
  • get-air-quality-daily for 3-day air quality outlook

Developer Notes

Everything you need for local build and runtime wiring.

Build commands

  • npm run build for TypeScript compile and executable setup
  • npm run build:windows for Windows packaging flow

Project layout

  • Source entry: src/index.ts
  • Build output: build/index.js

Required environment

  • QWEATHER_API_BASE
  • QWEATHER_API_KEY