| 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-cli
Setup
- Create account at beestat.io and link your ecobee
- Email contact@beestat.io with your thermostat serial number to get an API key
- Set environment variable:
export BEESTAT_API_KEY="your-key"
Commands
Status
beestat status
beestat status --json
Sensors
beestat sensors
beestat sensors --json
Air Quality
beestat air-quality
beestat aq
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
beestat thermostats
beestat thermostats --json
Runtime Summary
beestat summary
beestat summary --days 14
beestat summary --json
Force Sync
beestat sync
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
--json for scripting/automation
- Use
beestat sync if data seems stale