- 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
npm install -g beestat-cliSetup
- 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 --jsonSensors
beestat sensors # All sensors with temperature and occupancy
beestat sensors --jsonAir Quality
beestat air-quality # CO2, VOC, and air quality score
beestat aq # Short alias
beestat aq --jsonRequires 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
beestat thermostats # Model info, HVAC details
beestat thermostats --jsonRuntime Summary
beestat summary # Runtime history (default 7 days)
beestat summary --days 14 # Last 14 days
beestat summary --jsonForce Sync
beestat sync # Force sync with ecobeeUsage Examples
User: "What's the temperature in the house?"
beestat statusUser: "Is the air quality okay?"
beestat aqUser: "Is anyone in the bedrooms?"
beestat sensorsUser: "How much did we heat the house this week?"
beestat summary --days 7User: "What thermostats do we have?"
beestat thermostatsNotes
- Air quality data comes from ecobee runtime, not sensor capabilities
- All commands support
--jsonfor scripting/automation - Use
beestat syncif data seems stale