Skip to content
MCP server

Netatmo Energy

Ask AI about Netatmo thermostat and radiator valve data, with optional confirmed control

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

Similar MCP servers

About Netatmo Energy

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

Heating data from Netatmo thermostats and smart radiator valves usually stays in the vendor app, where you can look but not question it. This server runs on your machine, talks only to the official Netatmo Energy API, and lets an assistant answer questions such as which room was coldest last night.

It exposes 15 read-only tools, 6 heating-control tools, 4 resources and 4 prompts (daily report, anomaly review, room comparison and heating pattern review). Coverage includes room temperatures and setpoints, boiler activity, open-window detection, battery and signal health, history from 30 minutes to a month with gaps reported rather than filled, deterministic analytics and weekly schedules. No AI model computes the numbers.

It is read-only by default. Write mode, enabled at login, allows temporary setpoints, away or frost-guard mode and schedule edits, each previewed and confirmed, with a default 7 to 28 degree Celsius range. Setup uses a free Netatmo developer app and OAuth login; version 0.3.2 is labelled an early release. A remote option exists for web and mobile assistants.

Install

Run in a terminal

claude mcp add netatmo-energy-mcp --env NETATMO_CLIENT_SECRET='<NETATMO_CLIENT_SECRET>' -- npx -y netatmo-energy-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netatmo-energy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netatmo-energy-mcp"
      ],
      "env": {
        "NETATMO_CLIENT_SECRET": "<NETATMO_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netatmo-energy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netatmo-energy-mcp"
      ],
      "env": {
        "NETATMO_CLIENT_SECRET": "<NETATMO_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "netatmo-energy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "netatmo-energy-mcp"
      ],
      "env": {
        "NETATMO_CLIENT_SECRET": "<NETATMO_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "netatmo-energy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netatmo-energy-mcp"
      ],
      "env": {
        "NETATMO_CLIENT_SECRET": "<NETATMO_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "netatmo-energy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netatmo-energy-mcp"
      ],
      "env": {
        "NETATMO_CLIENT_SECRET": "<NETATMO_CLIENT_SECRET>"
      }
    }
  }
}

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

Configuration

  • NETATMO_CLIENT_IDNetatmo app client ID. Optional after running `npx -y netatmo-energy-mcp login`, which stores it.
  • NETATMO_CLIENT_SECRETNetatmo app client secret. Optional after `login`, which stores it locally.
  • NETATMO_MCP_LOG_LEVELLog level written to stderr: debug, info, warn, error or silent.
  • NETATMO_MCP_WRITESet to 0 to force read-only mode. Write mode is only possible after `login --write`.
  • NETATMO_MCP_CONFIRMWrite mode confirmation: auto (default), elicitation (client dialog only) or token (preview + token only).
  • NETATMO_MCP_MIN_TEMPWrite mode: lowest temperature a change may set, in °C (default 7).
  • NETATMO_MCP_MAX_TEMPWrite mode: highest temperature a change may set, in °C (default 28).
  • NETATMO_MCP_MAX_SETPOINT_HOURSWrite mode: longest manual room setpoint, in hours (default 24).

Tools this server provides (3)

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

netatmo_get_room_status
Room temperature and setpoint status
netatmo_get_heating_status
Boiler and heating demand status
netatmo_get_boiler_history
Boiler activity history

What it does

Room and boiler status
Temperatures, setpoints, heating demand and boiler on/off.
History
Room and boiler history, with long ranges summarised and gaps reported.
Deterministic analytics
Time within setpoint, cool-down rates, rankings and unusual-reading detection.
Weekly schedules
Reads zones, room setpoints and timetables.
Confirmed write mode
Opt-in control with previews and temperature limits.
Doctor command
Checks that setup is correct.

Good for

  • Find which room runs coldest overnight
  • See how long the boiler ran yesterday
  • Review heating schedules in plain language
  • Set a bedroom to 19 degrees until morning with confirmation
  • Spot unusual temperature readings

Pricing

Open source

Free; runs locally with a free Netatmo developer app

Netatmo Energy FAQ

Is it read-only?

Yes by default; write mode needs login --write.

What do I need?

Node.js 22.19 or later and a Netatmo account with Energy devices.

Does it call other services?

It talks only to the official Netatmo Energy API.

Which temperatures can it set?

7 to 28 degrees Celsius by default.

Is Netatmo Energy free?

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

How do I add Netatmo Energy to Claude Code?

Run this command in your terminal: claude mcp add netatmo-energy-mcp --env NETATMO_CLIENT_SECRET='<NETATMO_CLIENT_SECRET>' -- npx -y netatmo-energy-mcp

What are the best alternatives to Netatmo Energy?

The closest alternatives to Netatmo Energy are Openei Urdb, Entso E, Home Automation Mcp, myIO and Gumball.

Where this comes from

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

How AIPoweredBot checks servers