# Qweather MCP

> Qweather MCP is an open-source MCP server for web search and scraping. MCP server giving AI clients current weather, forecasts, warnings and air quality. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/overstarry/qweather-mcp
- **MCP Registry name:** io.github.overstarry/qweather-mcp
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [AgentLens Page Studio](https://ai-powered.com/mcp/agentlens-page-studio): AgentLens Page Studio is an MCP server for web search and scraping.
- [Lorem Picsum](https://ai-powered.com/mcp/lorem-picsum): Lorem Picsum is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/qweather-mcp
