Skip to main content
Glama

OpenWeatherMap MCP Server

OpenWeatherMap MCP Server

A Model Context Protocol (MCP) server that provides comprehensive weather data and forecasts through the OpenWeatherMap API. This server enables AI assistants to access real-time weather information, forecasts, air quality data, and location services.

Features

Weather Tools

  • Current Weather - Get current conditions for any location

  • Weather Forecast - 5-day weather forecast with 3-hour intervals

  • Hourly Forecast - Detailed hourly forecasts for up to 48 hours

  • Daily Forecast - Daily weather forecasts for up to 8 days with temperature ranges and astronomical data

  • Minutely Forecast - Minute-by-minute precipitation forecasts for the next hour

  • Weather Alerts - Active weather warnings and alerts with severity classification

Air Quality & Location

  • Current Air Pollution - Real-time air quality index and pollutant measurements

  • Location Info - Reverse geocoding to get location details from coordinates

  • OneCall Weather - Comprehensive weather data combining multiple forecasts

  • Air Pollution - Historical and forecast air quality data

  • Geocoding - Convert location names to coordinates

Installation

Prerequisites

Setup

  1. Clone the repository:

git clone https://github.com/robertn702/mcp-openweathermap.git cd mcp-openweathermap
  1. Install dependencies:

bun install
  1. Set up your environment variables:

cp .env.example .env # Edit .env and add your OpenWeatherMap API key

Environment variables:

  • OPENWEATHER_API_KEY - Your OpenWeatherMap API key (required for stdio transport only)

  • PORT - Server port for HTTP transport (default: 3000)

  • MCP_TRANSPORT - Transport type: stdio or httpStream (default: stdio)

  • MCP_ENDPOINT - HTTP endpoint path (default: /stream)

Usage

Running the Server

Stdio Transport (default):

bun run src/main.ts

HTTP Stream Transport:

MCP_TRANSPORT=httpStream PORT=3000 bun run src/main.ts

Claude Desktop Configuration

Add this configuration to your Claude Desktop MCP settings:

{ "mcpServers": { "openweathermap": { "command": "npx", "args": ["mcp-openweathermap"], "env": { "OPENWEATHER_API_KEY": "your-api-key-here" } } } }

API Tools

Weather Information

  • get-current-weather - Current weather conditions

  • get-weather-forecast - 5-day forecast

  • get-hourly-forecast - Hourly forecasts (up to 48 hours)

  • get-daily-forecast - Daily forecasts (up to 8 days)

  • get-minutely-forecast - Minute-by-minute precipitation

Alerts & Air Quality

  • get-weather-alerts - Weather warnings and alerts

  • get-current-air-pollution - Current air quality data

  • get-air-pollution - Air quality forecasts and history

Location Services

  • get-location-info - Reverse geocoding from coordinates

  • geocode-location - Convert addresses to coordinates

  • get-onecall-weather - Comprehensive weather data

Development

Running in Development

bun run src/main.ts

Testing with MCP Inspector

bun run src/main.ts

Then connect the MCP Inspector to test the tools interactively.

Build

bun run build

Authentication

Stdio Transport: Requires OPENWEATHER_API_KEY environment variable.

HTTP Transport: The OpenWeatherMap API key is passed as a bearer token in the HTTP request headers. No environment variable needed.

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides comprehensive weather data and forecasts through the OpenWeatherMap API, enabling AI assistants to access real-time weather information, forecasts, air quality data, and location services.

  1. Features
    1. Weather Tools
    2. Air Quality & Location
  2. Installation
    1. Prerequisites
    2. Setup
  3. Usage
    1. Running the Server
    2. Claude Desktop Configuration
  4. API Tools
    1. Weather Information
    2. Alerts & Air Quality
    3. Location Services
  5. Development
    1. Running in Development
    2. Testing with MCP Inspector
    3. Build
  6. Authentication
    1. Contributing
      1. License
        1. Support

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
            Last updated -
          • -
            security
            F
            license
            -
            quality
            A production-ready Model Context Protocol server that provides weather data from OpenWeatherMap API, allowing users to query current weather by city name or coordinates with support for different temperature units.
          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.
            Last updated -
            3
            4
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol (MCP) server that enables AI assistants and LLMs to access real-time weather data and forecasts by connecting to the OpenWeatherMap API.
            Last updated -
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/robertn702/mcp-openweathermap'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server