OpenWeatherMap MCP Server

An MCP server implementation that integrates the OpenWeatherMap API, providing current weather conditions and 5-day forecasts globally.

Features

• Current Weather: Get up-to-the-minute weather details for any location.
• 5-Day Forecast: Retrieve detailed 3-hourly forecast data for the next five days.
• Timezone Support: Specify timezone offsets for accurate local time reporting.

Tools

get_weather_forecast

Get current weather and 5-day forecast for a specified location.

• Inputs:
  • location (string, required): Location name, e.g., "Berlin", "New York", "Tokyo"
  • timezone_offset (number, optional, default: 0): Timezone offset in hours from UTC (e.g., 1 for Berlin, -4 for New York)
• Returns: An array of daily forecast objects, each containing the date and a list of forecast_entries (weather data points) for that day. The first entry on the first day is the current weather.

get_weather_current

Get the current weather conditions for a specified location.

• Inputs:
  • location (string, required): Location name, e.g., "Berlin", "New York", "Tokyo"
  • timezone_offset (number, optional, default: 0): Timezone offset in hours from UTC (e.g., 1 for Berlin, -4 for New York)
• Returns: A single weather entry object representing the current conditions.

Configuration

Getting an API Key

This server requires an API key from OpenWeatherMap.

1. Sign up for a free account at OpenWeatherMap.
2. Ensure your API key has access to the 5 day / 3 hour forecast endpoint. The standard free plan typically includes sufficient access for this endpoint.
3. Find your API key in your account settings on the OpenWeatherMap website.

Environment Variable

The server reads the API key from the OPENWEATHER_API_KEY environment variable.

Usage

Direct Invocation with npx

You can run the server directly using npx (ensure OPENWEATHER_API_KEY is set in your environment):

npx @vblagoje/openweather-mcp

Usage with an MCP Client (e.g., Claude Desktop)

Add this server configuration to your client's settings file (e.g., claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "weather": { 
      "command": "npx",
      "args": [
        "-y", // Optional: Skips confirmation if package needs download
        "@vblagoje/openweather-mcp" 
      ],
      "env": {
        "OPENWEATHER_API_KEY": "YOUR_API_KEY_HERE" 
      }
    }
    // ... other servers
  }
}

Replace "YOUR_API_KEY_HERE" with your actual OpenWeatherMap API key.

License

This MCP server is licensed under the ISC License. For more details, please see the LICENSE file in the project repository or the license field in package.json.