somneo-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@somneo-mcp-server stelle den Wecker auf 6:30 Uhr für Mo-Fr"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
somneo-mcp-server
MCP-Server für den Philips Somneo HF3671 (Wake-up Light): Wecker per Ansage lesen, ändern, schalten, anlegen und löschen. Dazu die Raumsensoren (nur lesen). Einschlaflicht, Lampe, Radio und Display sind nicht enthalten. Er spricht direkt die lokale HTTPS-API des Geräts, ohne App und ohne Cloud.
Werkzeuge
Tool | Wirkung |
| Schlafzimmer-Sensoren: Temperatur, Luftfeuchte, Licht (lux), Lärm (dB), aktuell + Mittel. ⚠️ Feuchte wich am 05.10. ~15 Punkte vom Shelly H&T ab |
| alle belegten Wecker (Slot, Uhrzeit, Tage, an/aus, Licht, Ton) |
| Uhrzeit, Tage ( |
| Wecker dauerhaft ein/aus |
| neuen Wecker im ersten freien Slot (Standard wie Mac-App: Hell. 20, 30 min, Weckton 1, Lautst. 12) |
| Wecker löschen, Slot wird frei (zurückgelesen) |
Jeder Schreibzugriff sendet nur die geänderten Felder, liest den Slot zurück und prüft jedes Feld (Muster aus der Mac-App Somneo-Menü).
Related MCP server: Eight Sleep MCP
Bewusst ohne Pause-Funktion
Für Urlaub werden die Wecker per Ansage aus- und danach wieder eingeschaltet. Es gibt kein automatisches Wiedereinschalten (Entscheidung 05.10.2026), denn kein anderes System soll in den Somneo schreiben.
Betrieb
uv sync
uv run pytest # 40 Tests, darunter Muss-rot-Fälle (Fake-Gerät für Anlegen/Löschen)
claude mcp add somneo -s user -- uv run --directory <pfad> somneo-mcpUmgebung (optional): SOMNEO_HOST (Standard wakeuplight.fritz.box).
Gerät: TLS höchstens 1.2, Cipher AES128-SHA, selbstsigniertes Zertifikat. Die erste Anfrage braucht ~2 s, danach ~0,1 s.
Docker
docker run -i --rm ghcr.io/schimmilab/somneo-mcp-server:latest
# anderer Host: docker run -i --rm -e SOMNEO_HOST=192.168.0.232 ghcr.io/schimmilab/somneo-mcp-server:latestReleases: Tag v* → Tests → Image bauen → MCP-Smoke gegen das gebaute Image → Push nach GHCR → GitHub-Release.
Available Tools
6 toolssomneo_raumklimaSomneo RaumklimaARead-only
Raumsensoren des Somneo im Schlafzimmer: Temperatur, Luftfeuchte, Licht (lux), Lärm (dB), jeweils aktuell und als Gerätemittel. ⚠️ Luftfeuchte wich am 05.10. um ~15 Prozentpunkte vom Shelly H&T im selben Raum ab (Temperatur nur 0,7 K) — Feuchte nicht ungeprüft als Raumwert nehmen.
Inputs: no named parameters. Returns: result
somneo_wecker_anlegenSomneo Wecker AnlegenA
Neuen Wecker im ersten freien Slot anlegen. Nicht angegebene Einstellungen wie in der Mac-App: Helligkeit 20, Lichtdauer 30 min, Lichttyp 0, Weckton 1, Lautstärke 12. Rückgabe: zurückgelesener Zustand.
Inputs: uhrzeit (required), an, tage, klang, +5 more. Returns: result
somneo_wecker_listeSomneo Wecker ListeARead-only
Alle belegten Wecker des Somneo: Slot, Uhrzeit, Wochentage, an/aus, Licht (Helligkeit, Dauer, Typ), Ton.
Inputs: no named parameters. Returns: result
somneo_wecker_loeschenSomneo Wecker LoeschenADestructiveIdempotent
Einen Wecker löschen (Slot wird freigegeben). Nicht rückgängig zu machen: vorher mit somneo_wecker_liste prüfen und den Wecker nennen. Rückgabe: Zustand vorher und Bestätigung.
Inputs: slot (required). Returns: result
somneo_wecker_schaltenSomneo Wecker SchaltenAIdempotent
Wecker ein- oder ausschalten, z. B. für Urlaub alle Werktags-Wecker aus und danach wieder an. Ausgeschaltete Wecker bleiben aus, es gibt kein automatisches Wiedereinschalten.
Inputs: an (required), slots (required). Returns: result
somneo_wecker_setzenSomneo Wecker SetzenAIdempotent
Einen bestehenden Wecker ändern. Nur angegebene Felder werden geändert. uhrzeit 'HH:MM' · tage z. B. 'Mo-Fr', 'Sa,So', 'täglich' · an True/False · helligkeit 1–25 · lichtdauer 1–60 min (Sonnenaufgang vor der Weckzeit) · lichttyp 0–3 · tonquelle 'Weckton' | 'Radio' | 'aus' · klang 0–10 · lautstaerke 1–25. Rückgabe: vom Gerät zurückgelesener Zustand.
Inputs: slot (required), an, tage, klang, +6 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each alarm tool maps to a distinct CRUD action (list, create, update, delete) plus an on/off toggle, and raumklima is a separate sensor domain. The only slight overlap is somneo_wecker_schalten (on/off) versus somneo_wecker_setzen, which can also set the 'an' flag, but the descriptions clarify the intended split.
Names follow a predictable somneo_<resource>_<action> pattern with German verbs (schalten, liste, setzen, anlegen, loeschen) for the alarm resource. somneo_raumklima deviates by being a bare resource noun with no action verb, a minor inconsistency.
Six tools is well-scoped for a single-device controller: full alarm lifecycle plus a sensor read. Every tool earns its place with no redundancy or bloat.
The alarm surface covers the full lifecycle (list, create, update, delete, enable/disable), and room climate provides the environmental read. No obvious dead ends or missing operations for the stated device purpose.
Maintenance
Related MCP Connectors
Yeelight device discovery, state, control, and scene execution.
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.
Unofficial Sunrise-Sunset MCP — wraps the sunrisesunset.io API (free, no auth)
Read-only solar inverter monitoring (SolarEdge, Enphase, Huawei, Fronius): plants, energy, alarms.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables discovery and control of Philips Hue lighting devices via a local bridge using the CLIP v2 API, without any cloud dependency.10MIT
- AlicenseBqualityBmaintenanceUnofficial Eight Sleep MCP server for sleep trends, temperature, alarms and gated pod control.26138 npm6MIT
- AlicenseAqualityCmaintenanceEnables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.9MIT
- AlicenseAqualityBmaintenanceEnables controlling Amazon Alexa accounts through Alexa's private web API, including listing and controlling Echo speakers, Echo Shows and Fire TVs, making devices speak or announce, running routines, controlling smart-home devices and scenes, managing shopping and to-do lists, and viewing alarms, timers and reminders. Destructive actions are confirmation-gated, and arbitrary voice commands are deliberately excluded.38149 npm1MIT