Weather MCP ClaudeDesktop

What SaintDoresh/Weather-MCP-ClaudeDesktop MCP server does

SaintDoresh/Weather-MCP-ClaudeDesktop MCP server brings OpenWeatherMap data into Claude Desktop through a locally running MCP process. It is designed for questions about conditions in a named location or coordinates, short-range forecasts, recent weather history, air quality, and active weather warnings.

The available operations include:

• Retrieve current temperature, feels-like temperature, min/max values, conditions, wind, cloud cover, humidity, pressure, visibility, sunrise, and sunset.
• Retrieve forecast entries for up to five days, including precipitation probability and time-specific weather details.
• Retrieve air quality index values and pollutant measurements such as carbon monoxide, nitrogen dioxide, ozone, sulfur dioxide, PM2.5, and PM10.
• Retrieve historical weather for a specified date, with the README describing historical coverage for the last five days.
• Search for locations by name and return matching names, regions, countries, and coordinates.
• Retrieve weather alerts with sender, event, timing, description, and tags.

Responses are structured data. If a request fails, the tools return an error message, such as when a location cannot be found.

How it works

The process runs on the user’s machine and communicates with Claude Desktop through its MCP configuration. Claude sends a tool request, and the Python application queries the corresponding OpenWeatherMap service before returning the result.

Location search can be used to resolve a name into coordinates when several places share the same name. Other operations return location metadata alongside the requested weather information. The README also gives examples of asking Claude Desktop to compare weather or air quality across multiple cities, although each underlying lookup still depends on the OpenWeatherMap API.

Setup and configuration

SaintDoresh/Weather-MCP-ClaudeDesktop requires Python 3.10 or newer. Install the repository dependencies with:

pip install -r requirements.txt

An OpenWeatherMap API key is required. The documented configuration uses a .env file containing OPENWEATHER_API_KEY, with the application loading that value through python-dotenv. The README instructs users to update main.py to load the environment variable instead of keeping the key directly in the source. The key should not be committed to version control, and the project recommends adding .env to .gitignore.

Claude Desktop must be configured with an MCP server entry that launches the project’s main.py using Python. The example uses py -3.13 and an absolute path to the script. The server must remain running while Claude Desktop uses it. New OpenWeatherMap keys may take up to 24 hours to activate.

Limitations and notes

API availability and request frequency are governed by OpenWeatherMap. The README states that the free tier permits up to 60 calls per minute, so repeated or parallel requests may be throttled. An invalid or inactive key can produce a 401 error.

The repository is intended specifically for Claude Desktop integration. The provided configuration uses a local stdio-style process rather than a hosted endpoint. The project is released under the MIT License, while OpenWeatherMap access remains subject to that service’s account terms and API limits.