🌦️ Weekly Weather MCP Server
About
Weather MCP server which returns 7 days of detailed weather forecasts anywhere in the world
Details
- Author
- rossshannon
- GitHub stars
- 10
- Downloads
- 401
- Categories
- Media
Jump to
- Global weather queries using OpenWeatherMap geocoding
- Hourly forecasts for the next 48 hours
- 8-day daily forecasts with morning, afternoon, and evening data points
- Weather summaries and precipitation probabilities
- Detailed weather info: temperature, humidity, wind speed, and more
- Reports in multiple time zones via timezone offset parameter
- No separate configuration file; API key passed via environment or parameter
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🌦️ Weekly Weather MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain an OpenWeatherMap API key with One Call API 3.0 access, clone the repository, install dependencies (Python 3, virtual environment optional), and run python weather_mcp_server.py. Provide the API key via the OPENWEATHER_API_KEY environment variable or as a parameter to the tools. Configure your MCP client with the server command and optional autoApprove settings. Use the get_weather tool for comprehensive forecasts or get_current_weather for current conditions, supplying a location, optional timezone offset, and API key.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83c\udf26\ufe0f weekly weather mcp server": {
"weekly-weather-mcp": {
"command": "python3",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"weekly-weather-mcp": {
"command": "python3",
"args": [
"-m",
"venv",
"venv"
]
}
}🌦️ Weekly Weather MCP Server
A weather forecast MCP (Model Context Protocol) server providing 8-day global weather forecasts and current weather conditions using the OpenWeatherMap One Call API 3.0.
> This project builds upon an earlier project by Zippland, with modifications to support full week forecasts and additional time-of-day data points.
<div align="center">
<p><em>Animation showing Claude Desktop processing the weather data from the MCP Server</em></p>
</div>
<br>
<div align="center">
<p><em>Claude Desktop showing a detailed weather forecast with lawn mowing recommendations</em></p>
</div>
Features
- 🌍 Support for querying weather conditions anywhere in the world
- 🌤️ Hourly forecasts for the next 48 hours
- 📅 Provides detailed 8-day forecasts (today + following 7 days), with morning, afternoon, and evening data points
- 🌧️ Weather summaries and precipitation probabilities
- 🌡️ Detailed weather information including temperature, humidity, wind speed, etc.
- 📍 Support for reporting results in different time zones
- 🗂️ No separate configuration file needed; API key can be passed directly through environment variables or parameters
Usage
1. Get an OpenWeatherMap API Key with One Call API 3.0 Access (free)
1. Visit OpenWeatherMap and register an account
2. Subscribe to the “One Call API 3.0” plan (offers 1,000 API calls per day for free)
3. Wait for API key activation (this can take up to an hour)
About the One Call API 3.0
The One Call API 3.0 provides comprehensive weather data:
- Current weather conditions
- Minute forecast for 1 hour
- Hourly forecast for 48 hours
- Daily forecast for 8 days (including today)
- National weather alerts
- Historical weather data
API Usage and Limits
- Free tier: 1,000 API calls per day
- Default limit: 2,000 API calls per day (can be adjusted in your account)
- Billing: Any calls beyond the free 1,000/day will be charged according to OpenWeatherMap pricing
- Usage cap: You can set a call limit in your account to prevent exceeding your budget (including capping your usage at the free tier limit so no costs can be incurred)
- If you reach your limit, you’ll receive a HTTP 429 error response
> Note: API key activation can take several minutes up to an hour. If you receive authentication errors shortly after subscribing or generating a new key, wait a bit and try again later.
2. Clone the Repository and Install Dependencies
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
