Weekly Weather MCP Server logo

Weekly Weather MCP Server

by rossshannon

The Weekly Weather MCP Server provides 8-day global weather forecasts and current weather conditions using the OpenWeatherMap One Call API 3.0. It builds upon an earlier project, extending it to support full week forecasts and additional time-of-day data points.

View on GitHub

Last updated: N/A

What is Weekly Weather MCP Server?

The Weekly Weather MCP Server is a weather forecast server that provides comprehensive weather data, including current conditions and 8-day forecasts, through the Model Context Protocol (MCP). It leverages the OpenWeatherMap One Call API 3.0 to deliver detailed weather information.

How to use Weekly Weather MCP Server?

To use the server, you need an OpenWeatherMap API key with One Call API 3.0 access. Clone the repository, install dependencies, set your API key as an environment variable or pass it as a parameter, and then run the server. Configure your MCP client (e.g., Claude Desktop, Cursor) with the server's command and arguments.

Key features of Weekly Weather MCP Server

  • Support for querying weather conditions anywhere in the world

  • Hourly forecasts for the next 48 hours

  • 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

Use cases of Weekly Weather MCP Server

  • Planning outdoor activities based on weather forecasts

  • Determining the best time for gardening or lawn care

  • Checking current weather conditions for travel or daily routines

  • Integrating weather data into AI assistants or other applications

FAQ from Weekly Weather MCP Server

How do I get an OpenWeatherMap API key?

Visit OpenWeatherMap, register an account, and subscribe to the “One Call API 3.0” plan.

What data does the server provide?

The server provides current weather conditions, hourly forecasts for the next 48 hours, and daily forecasts for 8 days (today + 7 days), including morning, afternoon, and evening data points.

What are the available tools?

The server exposes two tools: get_weather (for comprehensive weather data) and get_current_weather (for current conditions only).

What parameters do the tools accept?

Both tools accept location (location name), api_key (OpenWeatherMap API key), and timezone_offset (timezone offset in hours).

What do I do if I get an 'Invalid API key' error?

Ensure you've subscribed to the 'One Call API 3.0' plan, API key activation can take up to an hour, and verify you have set the OPENWEATHER_API_KEY correctly in environment variables, or check that you’re providing the correct api_key parameter when calling the tools