Sleep Device Controller

The problem

Controlling smart beds manually through a mobile app prevents integration with home automation scripts or data analysis pipelines. Developers lack a structured way to programmatically manage temperatures, fetch biometric sensor data, and sync alarm schedules.

What it does

• Authenticates with the Eight Sleep API to manage session tokens.
• Lists available devices and maps individual side IDs for dual-zone control.
• Fetches high-resolution sensor data including heart rate, HRV, and respiratory metrics.
• Sets target temperatures for specific bed sides with safety clamping.
• Manages alarm configurations and weekly schedules via CLI or scripts.

Frameworks & tools

Eight Sleep API, cURL, Bash, Python, and jq.

Why this beats prompting it yourself

This skill handles the specific API handshake requirements and device side mapping logic that generic prompts miss. It includes built-in logic for handling offline devices with backoff strategies and stale data flagging to prevent script crashes.

Use cases

• Pre-heat the bed automatically based on external calendar events or sunset times.
• Export sleep biometrics to a private database for long-term health tracking.
• Sync bed alarms with phone or smart home morning routines.
• Monitor device connectivity and log hardware uptime.

Known limitations

Requires active Eight Sleep account credentials. Target temperatures are restricted to the 10-40°C range for safety.