🌦️ Weekly Weather MCP Server
@rossshannon
Weather MCP server which returns 7 days of detailed weather forecasts anywhere in the world
Overview
What is 🌦️ Weekly Weather MCP Server?
A weather forecast MCP server providing 8-day global weather forecasts and current weather conditions using the OpenWeatherMap One Call API 3.0. It is designed for users of MCP-compatible clients such as Claude Desktop and Cursor who need detailed, time-of-day weather data for planning.
How to use 🌦️ Weekly Weather MCP Server?
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.
Key features of 🌦️ Weekly Weather MCP Server
- 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
Use cases of 🌦️ Weekly Weather MCP Server
- Check current weather conditions anywhere in the world
- Plan outdoor activities like running, gardening, or kite flying for the best day
- Determine when to mow the lawn or water plants based on rainfall forecasts
- Combine with a calendar MCP server to create events from weather recommendations
FAQ from 🌦️ Weekly Weather MCP Server
How do I get an API key and activate it?
Register at OpenWeatherMap, subscribe to the “One Call API 3.0” plan (free tier offers 1,000 calls/day), and wait up to an hour for key activation. Set the key in the OPENWEATHER_API_KEY environment variable or pass it as the api_key parameter.
What if a location is not found or returns incorrect results?
Check for typos or use a more specific query with country/state codes (e.g., “Paris,FR”, “Portland,OR,US”). Very small or remote locations may not exist in OpenWeatherMap’s database.
What are the runtime and dependence requirements?
The server runs on Python 3 and requires the packages listed in requirements.txt. A virtual environment is recommended for isolation.
What are the API call limits?
The free tier allows 1,000 calls per day. The default account limit is 2,000 calls per day; you can adjust it. Exceeding the free tier incurs charges according to OpenWeatherMap pricing. A 429 error indicates rate limiting.
How does authentication and transport work?
Authentication is handled via the OpenWeatherMap API key, provided through an environment variable or function parameter. The server communicates over stdio using the Model Context Protocol (MCP), designed for local client integration.
