OpenWeather

Provides weather data and geocoding via OpenWeatherMap for MCP clients with current conditions, forecasts, and alerts.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tristau-openweathermap-mcp": {
      "command": "npx",
      "args": [
        "@tristau/openweathermap-mcp",
        "--apikey",
        "YOUR_API_KEY"
      ]
    }
  }
}

You can access weather data from OpenWeatherMap through a dedicated MCP server that exposes current conditions, forecasts, weather alerts, and geocoding. This server lets your AI agents and MCP clients fetch reliable weather information for any location worldwide, with flexible units and multilingual descriptions.

How to use

Use the MCP client to request weather data by calling the available tools. You can retrieve current conditions, hourly forecasts, daily forecasts, and active weather alerts for a location. You can also geocode locations from city names or zip codes to coordinates for precise queries. When you ask your assistant for weather, specify the location and desired units and language to tailor the results.

Practical usage patterns include: asking for the current weather in a city, requesting a multi-day forecast for a destination, checking weather alerts for a specific area, or geocoding a location to obtain coordinates for further queries.

How to install

Prerequisites you need before running anything: Node.js 18 or newer.

Install and run the MCP server directly with NPX. This requires an OpenWeatherMap API key with One Call API 3.0 access.

Configuration and usage notes

API key configuration is provided through the --apikey argument in the MCP client setup.

For Claude Desktop clients, configure the MCP server by adding an entry that uses npx to start the MCP server with your API key.

For GitHub Copilot in VS Code, configure the MCP client similarly with the appropriate command and arguments, and set type to stdio.

Additional notes

The server supports multiple units (standard, metric, imperial) and localizations. It provides current weather, hourly and daily forecasts, and weather alerts. It also offers geocoding capabilities to turn city names or zip codes into coordinates.

Available tools

get_current_weather

Fetches current weather conditions for a specified location, including temperature, humidity, wind, and sky conditions.

get_hourly_forecast

Retrieves hourly weather forecasts for up to 48 hours for the given location.

get_daily_forecast

Retrieves daily weather forecasts for up to 8 days for the given location.

get_weather_alerts

Returns active weather alerts for the specified location.

geocode_location

Converts location names into geographic coordinates (latitude and longitude) using geocoding.

geocode_zipcode

Converts zip or postal codes into geographic coordinates.