Beestat
/install beestat
Beestat CLI
CLI for the Beestat API (ecobee thermostat analytics). Query temperature, humidity, air quality, and HVAC runtime.
Installation
npm install -g beestat-cli
Setup
- Create account at beestat.io and link your ecobee
- Email [email protected] with your thermostat serial number to get an API key
- Set environment variable:
export BEESTAT_API_KEY="your-key"
Commands
Status
beestat status # Current temps, humidity, setpoints, weather
beestat status --json
Sensors
beestat sensors # All sensors with temperature and occupancy
beestat sensors --json
Air Quality
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:
- \x3C 800 ppm: Excellent
- 800-1000 ppm: Good
- 1000-1500 ppm: Fair (consider ventilation)
-
1500 ppm: High (ventilate!)
VOC Levels:
- \x3C 0.5 ppm: Excellent
- 0.5-1.0 ppm: Good
- 1.0-3.0 ppm: Fair
-
3.0 ppm: High
Thermostats
beestat thermostats # Model info, HVAC details
beestat thermostats --json
Runtime Summary
beestat summary # Runtime history (default 7 days)
beestat summary --days 14 # Last 14 days
beestat summary --json
Force Sync
beestat sync # Force sync with ecobee
Usage Examples
User: "What's the temperature in the house?"
beestat status
User: "Is the air quality okay?"
beestat aq
User: "Is anyone in the bedrooms?"
beestat sensors
User: "How much did we heat the house this week?"
beestat summary --days 7
User: "What thermostats do we have?"
beestat thermostats
Notes
- Air quality data comes from ecobee runtime, not sensor capabilities
- All commands support
--jsonfor scripting/automation - Use
beestat syncif data seems stale
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install beestat - After installation, invoke the skill by name or use
/beestat - Provide required inputs per the skill's parameter spec and get structured output
What is Beestat?
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. It is an AI Agent Skill for Claude Code / OpenClaw, with 1949 downloads so far.
How do I install Beestat?
Run "/install beestat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Beestat free?
Yes, Beestat is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Beestat support?
Beestat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Beestat?
It is built and maintained by Matt Russell (@mjrussell); the current version is v0.1.0.