Skip to main content
Glama
smhi-weather-forcast-mcp-server

smhi-weather-forcast-mcp-server

by ribomation

SMHI Weather Forecast MCP Server

A Model Context Protocol (MCP) server that provides access to SMHI (Swedish Meteorological and Hydrological Institute) weather data, including forecasts and historical observations.

Disclaimer 😳

This project is the result of an experiment of using Claude Code AI plus Wispr Flow, where I mostly talk via Wispr to Claude, which then implements an MCP server connecting to the Swedish weather data service (SMHI). You can find my article (in Swedish) at this url https://www.ribomation.se/blog/2026/sa-har-kopplar-du-smhi-till-claude-ai/

The main objective is the journey, not the end result. That means, read the article, use Claude and follow along with the prompts and recreate your own weather service MCP.

Related MCP server: mcp-danish-weather

Features

  • šŸŒ¤ļø Weather Forecasts - Get 10-day weather forecasts for any location in Sweden

  • šŸ“Š Historical Data - Access weather observations from 996+ SMHI stations

  • šŸ¢ Station Listings - Browse available weather stations by parameter

  • šŸ“‹ Parameter Catalog - List all 40+ available weather parameters

Installation

Prerequisites

  • Node.js 18.0.0 or higher

  • npm

Setup

  1. Clone the repository:

git clone https://github.com/ribomation/smhi-weather-forecast-mcp-server.git
cd smhi-weather-forecast-mcp-server
  1. Install dependencies:

npm install
  1. Build the server:

npm run build

Usage

With Claude Desktop

Add this to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "smhi-weather": {
      "command": "node",
      "args": [
        "/path/to/smhi-weather-forcast-mcp-server.js"
      ]
    }
  }
}

Then restart Claude Desktop.

With Other MCP Clients

The server uses stdio transport and can be integrated with any MCP client that supports stdio.

Available Tools

1. get-weather-forecast

Get weather forecast for a specific location.

Parameters:

  • longitude (number, required): Longitude coordinate (-180 to 180)

  • latitude (number, required): Latitude coordinate (-90 to 90)

  • category (string, optional): Forecast category (default: "pmp3g")

Example:

{
  "longitude": 18.0686,
  "latitude": 59.3293
}

Returns: Complete forecast data for ~10 days with hourly weather parameters.

2. get-weather-observations

Get historical weather observations from a SMHI station.

Parameters:

  • stationId (number, required): SMHI station ID

  • parameterId (number, required): Parameter ID (see common parameters below)

  • period (string, optional): Time period - one of:

    • "latest-hour" (default)

    • "latest-day"

    • "latest-months"

    • "corrected-archive"

Example:

{
  "stationId": 188790,
  "parameterId": 1,
  "period": "latest-hour"
}

Returns: Historical observation data with timestamps, values, and quality codes.

3. list-weather-stations

List available SMHI weather stations for a specific parameter.

Parameters:

  • parameterId (number, required): Parameter ID to filter stations

Example:

{
  "parameterId": 1
}

Returns: List of stations with ID, name, coordinates, elevation, and active status.

4. list-weather-parameters

List all available weather parameters.

Parameters: None

Returns: Complete list of queryable weather parameters with IDs and descriptions.

Common Weather Parameters

Parameter

ID

Description

Temperature

1

Air temperature (°C)

Wind Direction

3

Wind direction (degrees)

Wind Speed

4

Wind speed (m/s)

Precipitation

5

Precipitation (mm)

Humidity

6

Relative humidity (%)

Snow Depth

8

Snow depth (cm)

Pressure

9

Air pressure (hPa)

Visibility

12

Visibility (km)

Development

Scripts

  • npm run build - Build the project with tsup

  • npm run dev - Run in development mode with watch

  • npm run type-check - Type check without building

  • npm start - Start the built server

Project Structure

src/
ā”œā”€ā”€ index.ts              # Entry point
ā”œā”€ā”€ server.ts             # MCP server setup
ā”œā”€ā”€ services/
│   ā”œā”€ā”€ smhi-api.ts       # SMHI API client
│   ā”œā”€ā”€ types.ts          # TypeScript types
│   └── test-api.ts       # API test script
└── (tools/, utils/ - for future expansion)

dist/                     # Build output (generated)

API Documentation

This server uses the SMHI Open Data API:

Important Notes

āš ļø API Changes: SMHI is modernizing their APIs during spring 2026. The current APIs used by this server may be deprecated. Monitor SMHI's updates page for changes.

Examples

Get Stockholm Weather Forecast

Ask Claude:

"What's the weather forecast for Stockholm?"

Claude will use get-weather-forecast with Stockholm's coordinates (18.0686, 59.3293).

Find Temperature Stations

Ask Claude:

"List all active temperature measurement stations in Sweden"

Claude will use list-weather-stations with parameterId: 1 (temperature).

Get Historical Data

Ask Claude:

"Show me the temperature readings from Abisko station for the last hour"

Claude will:

  1. Use list-weather-stations to find Abisko's station ID

  2. Use get-weather-observations to fetch the temperature data

License

MIT


Built with Model Context Protocol by Anthropic.

Available Tools

4 tools
get-weather-forecastA

Get weather forecast for a specific location from SMHI. Returns forecast data for approximately 10 days ahead.

Inputs: latitude (required), longitude (required), category.

get-weather-observationsA

Get historical weather observations from a SMHI weather station.

Inputs: stationId (required), parameterId (required), period.

list-weather-parametersA

List all available weather parameters that can be queried from SMHI.

Inputs: no named parameters.

list-weather-stationsB

List available SMHI weather stations for a specific parameter.

Inputs: parameterId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: listing stations, listing parameters, fetching forecasts, and fetching observations. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent verb-noun pattern with lowercase and hyphens: list-weather-stations, list-weather-parameters, get-weather-forecast, get-weather-observations. The naming is uniform and predictable.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose. It covers metadata discovery and the two main data fetch operations without unnecessary bloat or thinness.

    Completeness5/5

    The tool surface covers the essential SMHI workflow: discover parameters, discover stations, get forecast, get observations. No critical dead ends are apparent for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides access to Dutch weather data (current conditions, forecasts, alerts, and historical data) via the KNMI API, with automatic location name resolution for Dutch cities.
      1
      15 npm
      1
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides access to Danish weather data from the Danish Meteorological Institute, enabling users to retrieve current conditions, hourly forecasts, and historical records. It supports location lookups via city names, postal codes, and coordinates for any Danish region.
      3
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides access to current weather conditions and hourly forecasts for any location in Sweden using the SMHI Open Data API. It supports built-in city lists, coordinate inputs, and geocoding fallback to deliver detailed meteorological data without requiring authentication.
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides real-time weather data, forecasts, and historical weather information from SMHI (Swedish Meteorological and Hydrological Institute) for any location in Sweden.
      2
      -