name: ring
description: Manage Ring doorbells, cameras, and alarm system
category: smarthome

Ring Skill

Overview

Enables Claude to interact with Ring for viewing doorbell and camera feeds, managing Ring Alarm, checking event history, and configuring device settings.

Quick Install

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

Or manually:

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

Setup

Configure via canifi-env:

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

canifi-env set RING_EMAIL "[email protected]"

Privacy & Authentication

Your credentials, your choice. Canifi LifeOS respects your privacy.

Option 1: Manual Browser Login (Recommended)

If you prefer not to share credentials with Claude Code:
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

If you're comfortable sharing credentials, you can store them locally:

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

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

Capabilities

• View live camera and doorbell feeds
• Check motion and ring event history
• Manage Ring Alarm system
• Configure motion zones and sensitivity
• View and download video clips

Usage Examples

Example 1: Check Doorbell

User: "Who rang the doorbell while I was out?"
Claude: I'll check the Ring doorbell history for recent visitors.

Example 2: Alarm Control

User: "Arm the Ring alarm in home mode"
Claude: I'll set your Ring Alarm to Home mode.

Example 3: Camera Status

User: "Are all my Ring cameras online?"
Claude: I'll check the status of all your Ring cameras.

Authentication Flow

1. Navigate to ring.com via Playwright MCP
2. Click "Log In" button
3. Enter Ring credentials
4. Handle 2FA via email or text
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
• 2FA Required: Wait for code via email/SMS
• Rate Limited: Implement exponential backoff
• Device Offline: Report device connectivity

Self-Improvement Instructions

When encountering new UI patterns:
1. Document Ring app/web changes
2. Update selectors for new layouts
3. Track new device features
4. Monitor subscription changes

Notes

• Ring Protect plan for video history
• Neighbors app for community alerts
• Alexa integration available
• Professional monitoring optional