Skip to content
MCP server

Aemet MCP

Spain's official AEMET forecasts, warnings, observations and climate data for AI clients

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.3
Listing updated
today

Similar MCP servers

About Aemet MCP

Aemet MCP is an open-source MCP server for energy and smart home. It runs locally on your machine and is started by your AI client.

Eight tools expose the open data of Spain's State Meteorological Agency, AEMET. Municipal forecasts cover more than 8,000 municipalities, daily or hourly for roughly the next 40 hours. Warnings use the Common Alerting Protocol format and can be filtered by area, language and minimum severity.

Other tools return the latest station observation near a place, daily climate records or monthly normals, a three-day beach forecast for 591 beaches in bathing season, and AEMET's bulletin for nine mountain areas, with freezing levels and refuge temperatures. Daily climate queries are capped at 186 days; longer ranges are rejected, and ranges over a month come back aggregated.

It runs locally over stdio on Node.js 20.19 or newer. Each user supplies a free AEMET API key, since there is no hosted service or shared key. It is built on the aemet-client SDK.

Install

Run in a terminal

claude mcp add aemet-mcp --env AEMET_API_KEY='<AEMET_API_KEY>' -- npx -y aemet-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aemet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aemet-mcp"
      ],
      "env": {
        "AEMET_API_KEY": "<AEMET_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aemet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aemet-mcp"
      ],
      "env": {
        "AEMET_API_KEY": "<AEMET_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "aemet-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aemet-mcp"
      ],
      "env": {
        "AEMET_API_KEY": "<AEMET_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aemet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aemet-mcp"
      ],
      "env": {
        "AEMET_API_KEY": "<AEMET_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aemet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aemet-mcp"
      ],
      "env": {
        "AEMET_API_KEY": "<AEMET_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AEMET_API_KEYAEMET OpenData API key. Free at https://opendata.aemet.es/centrodedescargas/altaUsuarioRequired

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

get_forecast
Official forecast for a Spanish municipality, daily or hourly.
get_warnings
Active CAP warnings for a region or the whole country.
get_nearest_observation
Latest observation from the nearest AEMET station.
get_climate_history
Daily records or monthly normals from the nearest station.
get_beach_forecast
Three-day forecast for a beach in the bathing season.
get_mountain_forecast
AEMET mountain bulletin for one of nine areas.

What it does

Municipal forecasts
Daily or hourly forecasts by name or INE code.
Weather warnings
CAP alerts filtered by area, language and severity.
Nearest observation
Latest temperature, wind, humidity and pressure from the closest station.
Climate history
Daily ranges up to 186 days or long-term monthly normals.
Beach forecasts
Sky, waves, water temperature and UV for 591 beaches.
Mountain bulletins
Freezing level and refuge temperatures for nine ranges.

Good for

  • Ask for this week's forecast for a Spanish town
  • Check active weather warnings in a region
  • Look up past rainfall at a station
  • Plan a beach or mountain trip

Pricing

Open source

Free; requires a free AEMET API key; licence file in repo

Aemet MCP FAQ

Do I need an API key?

Yes, a free AEMET OpenData key, delivered by email.

What languages do warnings support?

Spanish, English, Catalan, Galician and Basque.

What are the limits?

Daily climate requests are capped at 186 days.

Where does it run?

Locally over stdio, with Node.js 20.19 or later.

Is Aemet MCP free?

Yes. Aemet MCP is open source, so you can use and self-host it for free.

How do I add Aemet MCP to Claude Code?

Run this command in your terminal: claude mcp add aemet-mcp --env AEMET_API_KEY='<AEMET_API_KEY>' -- npx -y aemet-mcp

What are the best alternatives to Aemet MCP?

The closest alternatives to Aemet MCP are Atli, CAD2GIS, Coordinates, Photon and Travel Advisories.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers