# Netatmo Energy

> Netatmo Energy is an open-source MCP server for smart home. Ask AI about Netatmo thermostat and radiator valve data, with optional confirmed control. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, macOS, Windows, Linux
- **Repository:** https://github.com/christophe77/netatmo-energy-mcp
- **MCP Registry name:** io.github.christophe77/netatmo-energy-mcp
- **Categories:** [smart home](https://ai-powered.com/categories/smart-home), [energy and smart home](https://ai-powered.com/categories/energy-and-smart-home)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

## Alternatives

- [Openei Urdb](https://ai-powered.com/mcp/openei-urdb): Openei Urdb is a freemium MCP server for energy and smart home.
- [Entso E](https://ai-powered.com/mcp/entso-e): Entso E is a freemium MCP server for energy and smart home.
- [Home Automation Mcp](https://ai-powered.com/mcp/home-automation-mcp): Home Automation Mcp is a freemium MCP server for smart home.
- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [Gumball](https://ai-powered.com/mcp/gumball): Gumball is an open-source MCP server for smart home.
- [THRIVE Fleet Intelligence](https://ai-powered.com/mcp/thrive-fleet-intelligence): THRIVE Fleet Intelligence is a free MCP server for energy and smart home.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.

---
Source: https://ai-powered.com/mcp/netatmo-energy
