Netatmo Energy

Netatmo Energy MCP

English | Français

A Netatmo MCP server for Netatmo smart thermostats and smart radiator valves. It gives AI assistants structured access to your heating:

• room temperatures and setpoints
• heating demand and boiler activity
• temperature history
• deterministic heating analytics
• weekly heating schedules
• optional heating control: room setpoints, away / frost-guard mode and schedules, with every change confirmed by you

It runs on your machine and talks only to the official Netatmo Energy API. It is read-only by default: it can change your heating only if you enable write mode at login.

It works with any Model Context Protocol client that runs local servers, whatever the model:

• Claude: Claude Desktop, Claude Code
• GPT / OpenAI: Codex CLI, VS Code + GitHub Copilot, Cursor
• Gemini: Gemini CLI, VS Code + GitHub Copilot
• Mistral and others through multi-model clients
• Local LLMs (Llama, Qwen, Mistral, DeepSeek, …): LM Studio, and Ollama via Goose, Continue, Cline, AnythingLLM, LibreChat or Open WebUI

It also works in Windsurf / Devin Desktop, Zed, Roo Code, Kilo Code, JetBrains AI Assistant, Kiro and Warp. See all compatible clients.

ChatGPT and Claude on the web and on mobile only accept remote servers. For them, deploy the optional remote server to your own Cloudflare account (free plan).

Status: early release (0.3.2). The Netatmo API integration has been

validated on a real installation; feedback and device reports are welcome.

Why this project?

A Netatmo heating system records useful data:

• the temperature and setpoint of every room
• what each radiator valve is asking for
• when the boiler is asked to heat

That data is locked in the Netatmo app, where you can look at it but not ask questions about it.

This project is a small bridge between the Netatmo Energy API and any MCP-compatible AI assistant. Ask in plain language: "Which room was coldest last night?" The assistant calls a precise tool and answers from your data. It doesn't guess. With write mode enabled, you can also say "Set the bedroom to 19 °C until 7 am", then confirm the change.

The few other Netatmo MCP servers target Netatmo weather stations. This one is built for thermostats, radiator valves and heating history. See docs/research.md for the comparison.

Features

• Discovery: homes, rooms, thermostats, smart radiator valves, relays and gateways.
• Current status
• Per room: temperature, setpoint, setpoint mode and heating demand.
• Boiler on/off and open-window detection.
• Device health: battery, radio/Wi-Fi signal, reachability.
• History
• Room temperature and setpoint history at 30 min to 1 month resolution.
• Boiler activity history (installations with a Netatmo thermostat).
• Long ranges are fetched in chunks and summarised, so answers stay small.
• Gaps are reported, never filled in.
• Heating analytics. These are deterministic calculations; no AI model computes the numbers.
• Per-room statistics.
• Time below, within or above the setpoint.
• Largest temperature drop and cool-down rates.
• Room rankings.
• Rule-based detection of unusual readings, each with severity and confidence.
• Weekly schedules: zones (Comfort, Night, Eco…), room setpoints per zone and the timetable, as readable days and times.
• Heating control (opt-in write mode)
• Temporary room setpoints that always end (3 h by default, at most 24 h), or a return to the schedule.
• Home mode: schedule, away or frost guard, optionally until a date.
• Switch, create, edit and rename weekly schedules.
• Every change is previewed and needs your explicit confirmation. Temperatures are limited to 7–28 °C by default.
• 15 read-only MCP tools, 6 heating-control tools, 4 resources and 4 prompts (daily report, anomaly review, room comparison, heating pattern review).
• Simple setup
• OAuth2 browser login with a single login command.
• Tokens stored securely and refreshed automatically.
• doctor checks your setup.

Quick start

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

1. Create a free Netatmo developer app

1. At https://dev.netatmo.com/apps, choose Create.
2. Set the redirect URI to http://localhost:8977/callback.
3. Keep the client ID and client secret for step 2.

Step-by-step guide: docs/authentication.md.

2. Log in

npx -y netatmo-energy-mcp login

login asks for the client ID and secret, then opens your browser so you can sign in on netatmo.com and approve read-only access. To let the assistant change your heating, run login --write instead (see write mode). Then check the setup:

npx -y netatmo-energy-mcp doctor

Running from source instead: clone the repository, run

pnpm install && pnpm build, then use

node /path/to/netatmo-energy-mcp/dist/index.js in place of

npx -y netatmo-energy-mcp.

3. Connect your AI assistant

Most clients use the same mcpServers JSON block. This works for Claude Desktop, Cursor, Windsurf / Devin Desktop, Cline, Roo Code, Kiro, LM Studio, JetBrains AI Assistant, AnythingLLM, Warp and Gemini CLI:

{

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

Command-line clients:

# Claude Code

claude mcp add --transport stdio --scope user netatmo-energy -- npx -y netatmo-energy-mcp

OpenAI Codex CLI

codex mcp add netatmo-energy -- npx -y netatmo-energy-mcp

GitHub Copilot CLI

copilot mcp add netatmo-energy -- npx -y netatmo-energy-mcp

Claude Code plugin. Instead of claude mcp add, install the plugin: it adds the server plus a skill that teaches Claude how to diagnose a cold room, write heating reports and change the heating safely. Inside Claude Code:

/plugin marketplace add christophe77/netatmo-energy-mcp

/plugin install netatmo-energy@netatmo-energy-mcp

See examples/claude-code.

VS Code + GitHub Copilot. Add this to .vscode/mcp.json; note the servers key:

{

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

No secrets go in any of these files: login stored them in your user configuration folder. File locations for each client, plus Zed, Continue, Goose, LibreChat, Kilo Code, Msty and Open WebUI, are in examples/.

4. Ask

"What's the temperature in each room right now?"

Example questions

These are the kinds of questions the tools are built for. The assistant chooses the tools; the table shows which ones answer each question.

Boiler "run time" is the time the thermostat requested heat. Netatmo does not measure gas or energy consumption, so this project never reports it.

Available MCP tools

The read-only tools need only the read_thermostat OAuth scope. The full reference, with arguments and outputs, is generated from the server itself: docs/tools.md.

Write mode only. Each change needs your confirmation.

| netatmo_set_room_setpoint | Temporary room setpoint or boost, or