Log inSubmit server
Qweather MCP logo

Qweather MCP

Queries QWeather for current conditions, forecasts, warnings, weather indices, precipitation, and air-quality data over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Qweather MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "YOUR_VALUE_HERE",
        "QWEATHER_PROJECT_ID": "YOUR_VALUE_HERE",
        "QWEATHER_KEY_ID": "YOUR_VALUE_HERE",
        "QWEATHER_PRIVATE_KEY_PATH": "YOUR_VALUE_HERE",
        "QWEATHER_PRIVATE_KEY": "YOUR_VALUE_HERE",
        "QWEATHER_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 9 tools correctly (9d ago).

Overview

The qweather-mcp MCP server connects MCP clients to the QWeather API for current conditions, forecasts, warnings, weather indices, precipitation, and air-quality data. It runs as a stdio process and authenticates with either JWT using EdDSA/Ed25519 or the legacy API key method. Reach for it when an agent needs location-based weather or air-quality information from QWeather. Forecast tools cover multiple daily ranges, hourly periods, and two-hour minute-level precipitation.

Use cases

  • Answer current-weather questions for a specified location
  • Plan activities with multi-day or hourly forecasts
  • Check near-term rain or snow minute by minute
  • Summarize weather warnings and safety recommendations
  • Assess air quality and related health guidance

Key features

  • Current weather queries
  • 3- to 30-day forecasts
  • 24- to 168-hour forecasts
  • Two-hour minute-level precipitation
  • Weather warnings and lifestyle indices
  • Current and forecast air-quality data

Tools9

What Qweather MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

8/8 checks healthy over the last 58d

What it can do

From the 9 tools this server returned when we ran it.

Read-only tools · 9
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age570 days
Maintainers1

Observed 2026-10-26 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · qweather-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
npm downloads274Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed9Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Qweather MCP works

What qweather-mcp does

The qweather-mcp MCP server exposes QWeather data as tools that an MCP-compatible client can call. It covers current weather, daily forecasts, hourly forecasts, short-term precipitation, weather warnings, lifestyle indices, and air quality.

The daily forecast tool supports 3, 7, 10, 15, and 30-day ranges. Forecast responses can include temperature highs and lows, day and night conditions, sunrise and sunset, precipitation, humidity, wind, and UV information. The hourly tool supports 24, 72, or 168 hours and returns details such as temperature, wind, humidity, pressure, precipitation probability, and cloud coverage.

How it works

The qweather-mcp MCP server starts as a Node-based stdio process. An MCP client launches it with npx -y qweather-mcp, then supplies QWeather credentials through environment variables. Requests made through the tools are sent to the configured QWeather API base URL.

Two authentication modes are available. JWT mode uses a QWeather project ID, credential ID, and an Ed25519 private key supplied through a file path or directly as PEM content. The server signs EdDSA tokens, backdates their issue time by 30 seconds, gives them a 15-minute lifetime, and reuses them until shortly before expiry. API key mode uses QWEATHER_API_KEY and is intended as the legacy option.

Setup and configuration

Create credentials in the QWeather Console before starting the server. Set QWEATHER_API_BASE to the API host required by the account. For JWT authentication, also set QWEATHER_PROJECT_ID, QWEATHER_KEY_ID, and either QWEATHER_PRIVATE_KEY_PATH or QWEATHER_PRIVATE_KEY. If both private-key variables are present, the file path takes precedence. Literal \\n sequences in the direct key value are converted to line breaks.

For API key authentication, set QWEATHER_API_KEY instead of the complete JWT configuration. Complete JWT settings take precedence if both authentication types are present. Partial JWT settings without a usable API key cause startup failure; missing credentials also produce a startup error. The selected authentication mode is written to stderr when the process starts.

A basic MCP client configuration uses npx as the command, -y qweather-mcp as its arguments, and the required variables in the client's env block. Smithery provides an installation command for Claude Desktop.

Tools and capabilities

The qweather-mcp MCP server provides these tool groups:

  • get-weather-now for current conditions at a location.
  • get-weather-forecast for configurable multi-day forecasts.
  • get-minutely-precipitation for rain or snow predictions at minute resolution over the next two hours.
  • get-hourly-forecast for 24-, 72-, or 168-hour forecasts.
  • get-weather-warning for warning authorities, levels, types, validity, content, and recommendations.
  • get-weather-indices for sports, car washing, clothing, fishing, UV, tourism, allergy, and other lifestyle indices.
  • get-air-quality for current AQI, pollutants, health advice, and air-quality levels.
  • get-air-quality-hourly for the next 24 hours of air-quality forecasts.
  • get-air-quality-daily for three-day air-quality forecasts.

Limitations and notes

QWeather credentials and an appropriate API base URL are required; the server does not provide weather data without access to the QWeather API. API key authentication is documented as a legacy mode, while QWeather recommends JWT authentication and has announced API key deprecation for 2027. The material documents stdio operation and does not describe another transport. Forecast availability and returned fields depend on the corresponding QWeather API data for the requested location.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Qweather MCP

qweather-mcp is an MCP server that connects AI clients to the QWeather API. Its main tools query current conditions, forecasts, minute-level precipitation, weather warnings, weather indices, and current or forecast air quality. It supports JWT with EdDSA/Ed25519 and legacy API key authentication.

Install it by running `npx -y qweather-mcp` and adding the command plus its environment variables to your MCP client configuration. Smithery also provides an installation command for Claude Desktop. You must obtain QWeather credentials before starting the server.

Configure either JWT or API key authentication through environment variables. JWT requires the project ID, key ID, and a private key path or PEM value; API key mode requires `QWEATHER_API_KEY`. Complete JWT settings take precedence when both modes are present.

Yes, qweather-mcp works with Claude Desktop through its stdio configuration. You can install it with the documented Smithery command or add `npx -y qweather-mcp` manually, along with `QWEATHER_API_BASE` and the required JWT or API key variables.

Related MCP servers

All in Environment & Nature All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewQweather MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/qweather-mcp?style=directory)](https://allmcps.com/mcp/qweather-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/qweather-mcp"><img src="https://allmcps.com/api/badge/qweather-mcp?style=directory" alt="Qweather MCP on AllMCPs" /></a>