OpenMeteo MCP Server

A Model Context Protocol (MCP) server that provides access to weather data and forecasts through the OpenMeteo API. This server enables AI assistants to retrieve current weather conditions, forecasts, historical weather data, and search for locations worldwide.

Features

• Current Weather: Get real-time weather conditions including temperature, humidity, precipitation, wind, and atmospheric pressure
• Weather Forecasts: Retrieve detailed weather forecasts for up to 16 days
• Historical Weather: Access historical weather data for analysis and comparison
• Location Search: Find coordinates and details for cities and locations worldwide
• Free API: Uses the free OpenMeteo API with no API key required
• Comprehensive Data: Includes temperature, precipitation, wind, pressure, cloud cover, and weather descriptions
• Smart Formatting: Human-readable weather reports with emojis and clear organization

Installation

Option 1: Download Pre-built Binary (Recommended)

Download the latest release from GitHub:

1. Visit the Releases Page: Go to https://github.com/gbrigandi/mcp-server-openmeteo/releases

2. Choose Your Version: Click on the latest release (or the specific version you want)

3. Download for Your Platform: In the "Assets" section, download the appropriate binary for your system:

   • macOS (Apple Silicon): mcp-server-openmeteo-aarch64-apple-darwin
   • macOS (Intel): mcp-server-openmeteo-x86_64-apple-darwin
   • Linux (64-bit): mcp-server-openmeteo-x86_64-unknown-linux-gnu
   • Windows (64-bit): mcp-server-openmeteo-x86_64-pc-windows-msvc.exe

4. Make it Executable (macOS/Linux only):

   chmod +x mcp-server-openmeteo
   

Option 2: Building from Source

If you prefer to build from source or need the latest development version:

Prerequisites

• Rust 1.87 or newer
• Cargo package manager

Build Steps

git clone https://github.com/gbrigandi/mcp-server-openmeteo
cd mcp-server-openmeteo
cargo build --release

The compiled binary will be available at target/release/mcp-server-openmeteo.

Usage

Basic Usage

Run the server with default settings:

./target/release/mcp-server-openmeteo

Environment Variables

You can control the logging level using the RUST_LOG environment variable:

# Enable debug logging
RUST_LOG=debug ./target/release/mcp-server-openmeteo

# Enable info logging (default)
RUST_LOG=info ./target/release/mcp-server-openmeteo

# Disable most logging
RUST_LOG=warn ./target/release/mcp-server-openmeteo

MCP Client Configuration

Claude Desktop

Add this server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openmeteo": {
      "command": "/path/to/mcp-server-openmeteo"
    }
  }
}

After adding the configuration:

1. Save the file
2. Restart Claude Desktop
3. The OpenMeteo weather tools will be available in your conversations

Available Tools

1. get_current_weather

Get current weather conditions for a specific location. Returns real-time weather data including temperature, humidity, precipitation, wind, and atmospheric conditions.

Parameters:

• latitude (required): Latitude coordinate (-90 to 90)
• longitude (required): Longitude coordinate (-180 to 180)

Returns:

• Current temperature and "feels like" temperature
• Relative humidity percentage
• Precipitation amount
• Wind speed, direction, and gusts
• Atmospheric pressure (mean sea level)
• Cloud cover percentage
• Weather condition description
• Day/night indicator

Example:

{
  "latitude": 40.7128,
  "longitude": -74.0060
}

2. get_weather_forecast

Get weather forecast for a specific location. Returns detailed

... View full README on GitHub