Skip to main content
Glama
somneo-mcp-server
by Schimmilab

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

somneo_raumklima

Schlafzimmer-Sensoren: Temperatur, Luftfeuchte, Licht (lux), Lärm (dB), aktuell + Mittel. ⚠️ Feuchte wich am 05.10. ~15 Punkte vom Shelly H&T ab

somneo_wecker_liste

alle belegten Wecker (Slot, Uhrzeit, Tage, an/aus, Licht, Ton)

somneo_wecker_setzen

Uhrzeit, Tage (Mo-Fr, Sa,So, täglich …), an/aus und Einstellungen eines Weckers ändern: Helligkeit 1–25, Lichtdauer 1–60 min, Lichttyp 0–3, Tonquelle (Weckton/Radio/aus), Klang 0–10, Lautstärke 1–25. Ungültige Werte werden vor dem Schreiben abgewiesen.

somneo_wecker_schalten

Wecker dauerhaft ein/aus

somneo_wecker_anlegen

neuen Wecker im ersten freien Slot (Standard wie Mac-App: Hell. 20, 30 min, Weckton 1, Lautst. 12)

somneo_wecker_loeschen

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

Umgebung (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:latest

Releases: Tag v* → Tests → Image bauen → MCP-Smoke gegen das gebaute Image → Push nach GHCR → GitHub-Release.

Available Tools

6 tools
somneo_raumklimaSomneo RaumklimaA
Read-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 ListeA
Read-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 LoeschenA
DestructiveIdempotent

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 SchaltenA
Idempotent

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 SetzenA
Idempotent

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

    A3.9/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables discovery and control of Philips Hue lighting devices via a local bridge using the CLIP v2 API, without any cloud dependency.
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      38
      149 npm
      1
      MIT