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.
When & Why to Use This Skill
The Beestat Claude skill provides a powerful integration for ecobee thermostat users to monitor and analyze their home climate data through the Beestat API. It enables real-time tracking of temperature, humidity, and air quality (CO2/VOC), alongside detailed HVAC runtime analytics and sensor occupancy status, helping users optimize home comfort and energy efficiency.
Use Cases
- Home Climate Monitoring: Instantly retrieve current indoor temperatures, humidity levels, and thermostat setpoints to ensure optimal comfort.
- Air Quality Tracking: Monitor CO2 and VOC levels with specific health-based thresholds to determine when better ventilation is required in the home.
- Energy Usage Analysis: Generate HVAC runtime summaries for the past week or month to identify heating and cooling patterns and reduce energy costs.
- Room Occupancy Checks: Query individual remote sensors to see which rooms are currently occupied and their specific temperature readings.
- Thermostat Hardware Management: Access detailed information about thermostat models, HVAC equipment configurations, and firmware status.
| 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 |
| emoji | "🌡️" |
| 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 # 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:
- < 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 --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