# Aemet MCP

> Aemet MCP is an open-source MCP server for energy and smart home. Spain's official AEMET forecasts, warnings, observations and climate data for AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jocarrd/aemet-client/tree/HEAD/packages/aemet-mcp
- **MCP Registry name:** io.github.jocarrd/aemet-mcp
- **Categories:** [energy and smart home](https://ai-powered.com/categories/energy-and-smart-home), [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Atli](https://ai-powered.com/mcp/atli): Atli is a free MCP server for maps and travel.
- [CAD2GIS](https://ai-powered.com/mcp/cad2gis): CAD2GIS is an open-source MCP server for engineering simulation.
- [Coordinates](https://ai-powered.com/mcp/coordinates): Coordinates is a freemium MCP server for maps and travel.
- [Photon](https://ai-powered.com/mcp/photon): Photon is a freemium MCP server for maps and travel.
- [Travel Advisories](https://ai-powered.com/mcp/travel-advisories): Travel Advisories is a freemium MCP server for maps and travel.
- [Sunvane Golden Hour](https://ai-powered.com/mcp/sunvane-golden-hour): Sunvane Golden Hour is an MCP server for maps and travel.
- [Openrouteservice](https://ai-powered.com/mcp/openrouteservice): Openrouteservice is a freemium MCP server for maps and travel.
- [Geodistance](https://ai-powered.com/mcp/geodistance): Geodistance is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/aemet-mcp
