Aemet MCP
Spain's official AEMET forecasts, warnings, observations and climate data for AI clients
- 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-mcpAdd 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.
