ecobee Skill

Overview

Quick Install

curl -sSL https://canifi.com/skills/ecobee/install.sh | bash

cp -r skills/ecobee ~/.canifi/skills/

Setup

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set ECOBEE_EMAIL "your-email@example.com"

Privacy & Authentication

Option 1: Manual Browser Login (Recommended)

1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Capabilities

• Control thermostat temperature and mode
• Manage room sensor occupancy
• Set comfort schedules
• View energy reports
• Configure vacation and away modes

Usage Examples

Example 1: Temperature Control

User: "Set the ecobee to 70 degrees"
Claude: I'll adjust your ecobee thermostat to 70 degrees.

Example 2: Schedule Management

User: "Set my ecobee to eco mode on weekdays"
Claude: I'll configure your ecobee schedule for eco mode during weekdays.

Example 3: Sensor Check

User: "Which rooms are currently occupied?"
Claude: I'll check your ecobee sensors for current occupancy status.

Authentication Flow

1. Navigate to ecobee.com via Playwright MCP
2. Click "Log In" button
3. Enter ecobee credentials
4. Handle verification if required
5. Maintain session for subsequent requests

Error Handling

• Login Failed: Retry authentication up to 3 times, then notify via iMessage
• Session Expired: Re-authenticate automatically
• Verification Required: Complete email verification
• Rate Limited: Implement exponential backoff
• Device Offline: Report thermostat connectivity

Self-Improvement Instructions

1. Document ecobee web portal changes
2. Update selectors for new layouts
3. Track new sensor capabilities
4. Monitor energy feature updates

Notes

• Room sensors for multi-zone comfort
• Smart Recovery learns heating/cooling times
• HomeKit, Alexa, and Google compatible
• Energy reports track usage patterns