playbooks

home / skills / openclaw / skills / beestat

beestat skill

/skills/mjrussell/beestat

This skill lets you monitor home temperature, humidity, air quality, and thermostat activity by querying the Beestat API for quick insights.

npx playbooks add skill openclaw/skills --skill beestat

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
2.4 KB
---
name: beestat
description: Query ecobee thermostat data via Beestat API including temperature, humidity, air quality (CO2, VOC), sensors, and HVAC runtime. Use when user asks about home temperature, thermostat status, air quality, or heating/cooling usage.
homepage: https://beestat.io
metadata:
  clawdbot:
    emoji: "🌡️"
    requires:
      bins: ["beestat"]
      env: ["BEESTAT_API_KEY"]
---

# Beestat CLI

CLI for the Beestat API (ecobee thermostat analytics). Query temperature, humidity, air quality, and HVAC runtime.

## Installation

```bash
npm install -g beestat-cli
```

## Setup

1. Create account at [beestat.io](https://beestat.io) and link your ecobee
2. Email [email protected] with your thermostat serial number to get an API key
3. Set environment variable: `export BEESTAT_API_KEY="your-key"`

## Commands

### Status

```bash
beestat status             # Current temps, humidity, setpoints, weather
beestat status --json
```

### Sensors

```bash
beestat sensors            # All sensors with temperature and occupancy
beestat sensors --json
```

### Air Quality

```bash
beestat air-quality        # CO2, VOC, and air quality score
beestat aq                 # Short alias
beestat aq --json
```

Requires ecobee Smart Thermostat Premium (has built-in air quality sensors).

**CO2 Levels:**
- < 800 ppm: Excellent
- 800-1000 ppm: Good
- 1000-1500 ppm: Fair (consider ventilation)
- > 1500 ppm: High (ventilate!)

**VOC Levels:**
- < 0.5 ppm: Excellent
- 0.5-1.0 ppm: Good
- 1.0-3.0 ppm: Fair
- > 3.0 ppm: High

### Thermostats

```bash
beestat thermostats        # Model info, HVAC details
beestat thermostats --json
```

### Runtime Summary

```bash
beestat summary            # Runtime history (default 7 days)
beestat summary --days 14  # Last 14 days
beestat summary --json
```

### Force Sync

```bash
beestat sync               # Force sync with ecobee
```

## Usage Examples

**User: "What's the temperature in the house?"**
```bash
beestat status
```

**User: "Is the air quality okay?"**
```bash
beestat aq
```

**User: "Is anyone in the bedrooms?"**
```bash
beestat sensors
```

**User: "How much did we heat the house this week?"**
```bash
beestat summary --days 7
```

**User: "What thermostats do we have?"**
```bash
beestat thermostats
```

## Notes

- Air quality data comes from ecobee runtime, not sensor capabilities
- All commands support `--json` for scripting/automation
- Use `beestat sync` if data seems stale

Overview

This skill queries ecobee thermostat data through the Beestat API to report temperature, humidity, air quality (CO2, VOC), sensor states, and HVAC runtime. It provides quick CLI-style answers for home temperature, thermostat status, occupancy, and heating/cooling usage. Use it to monitor comfort and indoor air quality from your ecobee devices.

How this skill works

The skill calls the Beestat API using your Beestat API key linked to an ecobee account and retrieves current runtime and historical data. It inspects thermostat status, individual sensor readings, built-in air quality metrics (CO2 and VOC when available), and HVAC runtime summaries. Results can be presented as structured data suitable for automation or plain-text summaries for conversational responses.

When to use it

  • Ask current indoor temperature, humidity, or setpoint for a thermostat or room.
  • Check occupancy or individual sensor temperatures (e.g., bedrooms, living room).
  • Assess indoor air quality using CO2 and VOC levels from ecobee Smart Thermostat Premium.
  • Get HVAC runtime history to understand heating/cooling usage over days or weeks.
  • Force a sync when data appears stale or after device changes.

Best practices

  • Ensure the Beestat account is linked to your ecobee thermostat and the API key is configured before querying.
  • Request --json-style structured output when integrating into automation or dashboards.
  • Ask for specific thermostat or sensor names to avoid ambiguous results in homes with multiple devices.
  • Use runtime summaries (7 or 14 days) to track trends rather than single-day readings for energy analysis.
  • Run a manual sync if recent changes aren’t reflected in responses.

Example use cases

  • "What’s the temperature in the house right now?" — returns current temps and setpoints for thermostats and sensors.
  • "Is the air quality okay in the main living area?" — reports CO2, VOC, and quality interpretation when supported.
  • "Who’s in the bedrooms?" — lists occupancy state from motion/occupancy sensors.
  • "How many hours did the furnace run last week?" — provides HVAC runtime summary for the requested period.
  • "What thermostats do we have and what models are they?" — reports thermostat models and HVAC configuration.

FAQ

Does air quality data work for all ecobee models?

Air quality (CO2 and VOC) is available only on ecobee Smart Thermostat Premium that exposes those runtime values to Beestat.

How fresh is the data returned by the skill?

Data frequency depends on ecobee and Beestat sync schedules; run a forced sync if you need immediate updates.