SmartThings Skill

Overview

Quick Install

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

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

Setup

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

canifi-env set SAMSUNG_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 Z-Wave and Zigbee devices
• Create automations and scenes
• Monitor device status
• Manage SmartThings hub
• Integrate third-party devices

Usage Examples

Example 1: Device Control

User: "Turn on the garage door sensor through SmartThings"
Claude: I'll check the status and control the garage door via SmartThings.

Example 2: Create Automation

User: "Create an automation to notify me when motion is detected at night"
Claude: I'll create a SmartThings automation for nighttime motion alerts.

Example 3: Scene Management

User: "Run my Away scene in SmartThings"
Claude: I'll activate your Away scene to set all devices appropriately.

Authentication Flow

1. Navigate to my.smartthings.com via Playwright MCP
2. Click "Sign In" button
3. Enter Samsung account credentials
4. Handle 2FA if enabled
5. Maintain session for subsequent requests

Error Handling

• Login Failed: Retry authentication up to 3 times, then notify via iMessage
• Session Expired: Re-authenticate with Samsung
• 2FA Required: Wait for code via email
• Rate Limited: Implement exponential backoff
• Hub Offline: Report hub connectivity status

Self-Improvement Instructions

1. Document SmartThings interface changes
2. Update selectors for new layouts
3. Track new device integrations
4. Monitor automation feature updates

Notes

• Supports Z-Wave, Zigbee, WiFi, Matter
• Samsung device deep integration
• Third-party device compatibility
• Requires SmartThings Hub for some devices