Kelvin: self-hosted control for Cozytouch radiators

Self-hosted web app for Sauter, Atlantic and Thermor electric radiators on Cozytouch, with the Linky meter's consumption priced in euros. One Docker container, a PWA on the phone, and a read-only MCP server so Claude can answer questions about the heating bill.

Source: https://github.com/lborruto/kelvin

Kelvin's home screen: each room with its temperature, alerts, this month's cost and today's schedule

Why build this

The Cozytouch app controls the radiators but says nothing about what they cost, and the Enedis and supplier sites show the bill but not which room spent it. Home Assistant can bridge the two, but that is a whole platform to run for one job.

Kelvin does that one job:

How it works

Phone / browser (SvelteKit PWA, French or English)
    │
    ▼
[FastAPI backend] ── SQLite in one data volume
    │
    ├─ Overkiz cloud (the Cozytouch app's API): rooms, setpoints, programmes, radiator kWh
    ├─ MyElectricalData: Linky daily and half-hour data, Tempo colours, EcoWatt
    ├─ Open-Meteo (optional): AROME / ARPEGE / ERA5-Land outdoor temperature
    └─ /mcp: read-only MCP server for Claude and other clients

Key choices

How to run it

git clone https://github.com/lborruto/kelvin.git && cd kelvin
cp .env.example .env
docker compose up -d --build

Open http://localhost:8070 and log in with the Cozytouch app's email and password. For energy and costs, add a free MyElectricalData token in Réglages › Linky.

To try it without radiators, run the built-in simulator (KELVIN_FAKE=1), an invented home with demo data. The README has the commands, the HTTPS reverse-proxy setup and the backup steps.

Keep it on the home network or a VPN: Kelvin is not made to face the internet.

Created 2026-10-30T20:02:23+01:00 · Edit