Weather

v0.6.1APIsstable

Provides weather information through OpenWeather API, enabling users to get current weather conditions, 5-day forecasts, and perform temperature conversions for any city. Offers a secure interface for AI assistants to access comprehensive weather dat

aiai-toolsmcpmcp-serverpython
Share:
49
Stars
0
Downloads
0
Weekly
0/5

What is Weather?

Weather is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides weather information through openweather api, enabling users to get current weather conditions, 5-day forecasts, and perform temperature conversions for any city. offers a secure interface for...

Provides weather information through OpenWeather API, enabling users to get current weather conditions, 5-day forecasts, and perform temperature conversions for any city. Offers a secure interface for AI assistants to access comprehensive weather dat

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Provides weather information through OpenWeather API, enabli

Use Cases

Weather forecasting via OpenWeather API
Temperature conversion and location queries
isdaniel

Maintainer

LicenseApache 2.0
Languagepython
Versionv0.6.1
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

PIP

pip install mcp-weather-server

Manual Installation

pip install mcp-weather-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Weather

The Weather MCP Server provides AI assistants with live weather data, multi-day forecasts, air quality readings, and timezone utilities through the free Open-Meteo API — no API key required. It exposes eight tools covering current conditions (temperature, humidity, wind speed, UV index), hourly data for any date range, air pollutant levels (PM2.5, PM10, ozone, NO2), and time zone conversion, making it easy to embed reliable weather awareness into any AI workflow. Because it uses Open-Meteo, which is fully free for non-commercial use, there are no quotas or billing surprises.

Prerequisites

  • Python 3.9 or higher with pip
  • No API key required — the server uses the free Open-Meteo API
  • For HTTP/SSE mode: starlette and uvicorn packages
  • An MCP-compatible client such as Claude Desktop, Cursor, or Cline
1

Install the package via pip

Install the mcp-weather-server package from PyPI. This is the simplest installation method.

pip install mcp-weather-server
2

Install optional HTTP dependencies (if needed)

If you want to run the server in SSE or Streamable HTTP mode (for remote clients), install the additional dependencies.

pip install mcp-weather-server starlette uvicorn
3

Test the server in stdio mode

Verify the server starts correctly by running it directly. It will wait for JSON-RPC input on stdin.

python -m mcp_weather_server
4

Configure Claude Desktop

Add the server to claude_desktop_config.json. No environment variables are needed.

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["-m", "mcp_weather_server"],
      "env": {}
    }
  }
}
5

Run in HTTP mode (optional, for remote access)

Start the server in streamable HTTP mode on a custom port to expose it over the network.

python -m mcp_weather_server --mode streamable-http --host 0.0.0.0 --port 8080

Weather Examples

Client configuration

Add this to claude_desktop_config.json. No API key is required — the server queries Open-Meteo directly.

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["-m", "mcp_weather_server"],
      "env": {}
    }
  }
}

Prompts to try

Ask Claude about current weather, forecasts, air quality, and time zones.

- "What is the current weather in Tokyo?"
- "Give me an hourly weather forecast for New York from tomorrow through next Friday"
- "What are the PM2.5 and ozone levels in Beijing right now?"
- "Convert 3:00 PM EST to Tokyo time"
- "What is the UV index in Sydney today and should I wear sunscreen?"

Troubleshooting Weather

ModuleNotFoundError: No module named 'mcp_weather_server'

Ensure you installed the package in the same Python environment Claude Desktop is configured to use. Run 'pip install mcp-weather-server' (note the hyphen in the package name) and verify with 'python -m mcp_weather_server --help'.

Weather data returns errors for some city names

Open-Meteo resolves city names via geocoding — use well-known spellings (e.g., 'Seoul' not 'Séoul'). For ambiguous cities, include the country (e.g., 'Springfield, US' vs 'Springfield, UK').

HTTP mode fails to start with 'uvicorn not found'

Install the HTTP extras: 'pip install starlette uvicorn'. These are not included in the base package and are only needed for SSE or Streamable HTTP transport modes.

Frequently Asked Questions about Weather

What is Weather?

Weather is a Model Context Protocol (MCP) server that provides weather information through openweather api, enabling users to get current weather conditions, 5-day forecasts, and perform temperature conversions for any city. offers a secure interface for ai assistants to access comprehensive weather dat It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Weather?

Install via pip with: pip install mcp-weather-server. Then configure your AI client to connect to this MCP server.

Which AI clients work with Weather?

Weather works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Weather free to use?

Yes, Weather is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "weather-mcp-server": { "command": "pip", "args": ["install", "mcp-weather-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Weather?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides