open-meteo-mcp-lite

open-meteo-mcp-lite

A lightweight MCP (Model Context Protocol) server for Open-Meteo weather API.

Simple, fast, no API key required.

Features

• Current weather: temperature, humidity, wind, pressure, UV index
• Forecasts: up to 16 days with daily high/low, precipitation, sunrise/sunset
• Hourly forecasts: up to 384 hours with temperature, precipitation, wind, pressure, UV index
• Location search: geocoding by city name
• Pressure data: surface pressure for weather tracking
• Default location: set once, query without specifying location

Installation

npm install -g open-meteo-mcp-lite

Or use with npx:

npx open-meteo-mcp-lite

Configuration

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "weather": {
      "type": "local",
      "command": ["npx", "-y", "open-meteo-mcp-lite"],
      "enabled": true
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "open-meteo-mcp-lite"]
    }
  }
}

Tools

set_default_location

Set a default location for weather queries. Stored in ~/.config/open-meteo-mcp-lite/config.json.

Parameters:

• location (string, optional): City name to set as default
• latitude (number, optional): Latitude coordinate
• longitude (number, optional): Longitude coordinate
• name (string, optional): Custom name for the location (used with coordinates)

Provide either location OR both latitude/longitude.

get_default_location

Get the currently configured default location.

search_location

Search for a location by name to get coordinates.

Parameters:

• query (string, required): City name or location to search
• limit (number, optional): Max results 1-10, default 5

get_weather

Get current weather conditions. Uses default location if none specified.

Parameters:

• location (string, optional): City name
• latitude (number, optional): Latitude coordinate
• longitude (number, optional): Longitude coordinate

get_forecast

Get weather forecast up to 16 days. Uses default location if none specified.

Parameters:

• location (string, optional): City name
• latitude (number, optional): Latitude coordinate
• longitude (number, optional): Longitude coordinate
• days (number, optional): Forecast days 1-16, default 7

get_hourly_forecast

Get hourly weather forecast up to 384 hours (16 days). Uses default location if none specified.

Parameters:

• location (string, optional): City name
• latitude (number, optional): Latitude coordinate
• longitude (number, optional): Longitude coordinate
• hours (number, optional): Forecast hours 1-384, default 24

Usage

Set your default location by city name:

> set_default_location(location="Barcelona")
Default location set to: Barcelona, Catalonia, Spain
Coordinates: 41.38879, 2.15899

Or by exact coordinates:

> set_default_location(latitude=41.5247, longitude=2.0214, name="Home")
Default location set to: Home
Coordinates: 41.5247, 2.0214

Then just ask for weather without specifying location:

> get_weather()
Location: Home

Current Weather (Europe/Madrid)
...

Example Output

Current Weather

Current Weather (Europe/Madrid)
Time: 2025-01-19T22:00

Temperature: 8.5°C
Feels like: 6.2°C
Humidity: 72%
Condition: Partly cloudy

Pressure: 1023.4 hPa

Wind: 12.3 km/h from 270°
Gusts: 18.5 km/h
UV Index: 0

Forecast

Weather Forecast (Europe/Madrid)

Mon, Jan 20
  Partly cloudy
  High: 14°C / Low: 5°C
  Precipitation: 0mm (0% chance)
  Wind: up to 15 km/h
  Sunrise: 08:15 / Sunset: 18:02

Hourly Forecast

Hourly Forecast (Europe/Madrid)

Mon, Jan 20
00:00  Partly cloudy  8.5°C, feels 6.2°C
       Humidity: 72%, Pressure: 1023.4 hPa
       Precip: 0mm (0%), Wind: 12.3 km/h from 270°, Gusts: 18.5 km/h, UV: 0

Config File

Default location is stored in: `` ~/.config/open-meteo-mcp-lite/config.json ``

Data Source

Weather data provided by Open-Meteo - free for non-commercial use.

License

MIT