Qweather MCP
MCP server giving AI clients current weather, forecasts, warnings and air quality
- 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-mcpAdd 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 hostRequiredQWEATHER_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.



