Netatmo Energy
Ask AI about Netatmo thermostat and radiator valve data, with optional confirmed control
- 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-mcpAdd 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.
