nest-devicesControl Nest smart home devices (thermostat, cameras, doorbell) via the Device Access API. Use when asked to check or adjust home temperature, view camera feeds, check who's at the door, monitor rooms, or set up temperature schedules.
Install via ClawdBot CLI:
clawdbot install amogower/nest-devicesControl Nest devices via Google's Smart Device Management API.
https://www.google.com as an authorized redirect URIRun the OAuth flow to get a refresh token:
# 1. Open this URL in browser (replace CLIENT_ID and PROJECT_ID):
https://nestservices.google.com/partnerconnections/PROJECT_ID/auth?redirect_uri=https://www.google.com&access_type=offline&prompt=consent&client_id=CLIENT_ID&response_type=code&scope=https://www.googleapis.com/auth/sdm.service
# 2. Authorize and copy the 'code' parameter from the redirect URL
# 3. Exchange code for tokens:
curl -X POST https://oauth2.googleapis.com/token \
-d "client_id=CLIENT_ID" \
-d "client_secret=CLIENT_SECRET" \
-d "code=AUTH_CODE" \
-d "grant_type=authorization_code" \
-d "redirect_uri=https://www.google.com"Store in 1Password or environment variables:
1Password (recommended):
Create an item with fields: project_id, client_id, client_secret, refresh_token
Environment variables:
export NEST_PROJECT_ID="your-project-id"
export NEST_CLIENT_ID="your-client-id"
export NEST_CLIENT_SECRET="your-client-secret"
export NEST_REFRESH_TOKEN="your-refresh-token"python3 scripts/nest.py list# Get status
python3 scripts/nest.py get <device_id>
# Set temperature (Celsius)
python3 scripts/nest.py set-temp <device_id> 21 --unit c --type heat
# Set temperature (Fahrenheit)
python3 scripts/nest.py set-temp <device_id> 70 --unit f --type heat
# Change mode (HEAT, COOL, HEATCOOL, OFF)
python3 scripts/nest.py set-mode <device_id> HEAT
# Eco mode
python3 scripts/nest.py set-eco <device_id> MANUAL_ECO# Generate live stream URL (RTSP, valid ~5 min)
python3 scripts/nest.py stream <device_id>from nest import NestClient
client = NestClient()
# List devices
devices = client.list_devices()
# Thermostat control
client.set_heat_temperature(device_id, 21.0) # Celsius
client.set_thermostat_mode(device_id, 'HEAT')
client.set_eco_mode(device_id, 'MANUAL_ECO')
# Camera stream
result = client.generate_stream(device_id)
rtsp_url = result['results']['streamUrls']['rtspUrl']The script checks for credentials in this order:
NEST_OP_VAULT and NEST_OP_ITEM (or use defaults: vault "Alfred", item "Nest Device Access API")NEST_PROJECT_ID, NEST_CLIENT_ID, NEST_CLIENT_SECRET, NEST_REFRESH_TOKEN| Setting | Celsius | Fahrenheit |
|---------|---------|------------|
| Eco (away) | 15-17Ā°C | 59-63Ā°F |
| Comfortable | 19-21Ā°C | 66-70Ā°F |
| Warm | 22-23Ā°C | 72-73Ā°F |
| Night | 17-18Ā°C | 63-65Ā°F |
For instant alerts when someone rings the doorbell or motion is detected, you need to set up Google Cloud Pub/Sub with a webhook.
gcloud) installed and authenticatedAdd to your clawdbot.json:
{
"hooks": {
"enabled": true,
"token": "your-secret-token-here"
}
}Generate a token: openssl rand -hex 24
gcloud config set project YOUR_GCP_PROJECT_ID
# Create topic
gcloud pubsub topics create nest-events
# Grant SDM permission to publish (both the service account and publisher group)
gcloud pubsub topics add-iam-policy-binding nest-events \
--member="serviceAccount:sdm-prod@sdm-prod.iam.gserviceaccount.com" \
--role="roles/pubsub.publisher"
gcloud pubsub topics add-iam-policy-binding nest-events \
--member="group:sdm-publisher@googlegroups.com" \
--role="roles/pubsub.publisher"Go to console.nest.google.com/device-access ā Your Project ā Edit ā Set Pub/Sub topic to:
projects/YOUR_GCP_PROJECT_ID/topics/nest-events# Install cloudflared
curl -L -o ~/.local/bin/cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
chmod +x ~/.local/bin/cloudflared
# Authenticate (opens browser)
~/.local/bin/cloudflared tunnel login
# Create named tunnel
~/.local/bin/cloudflared tunnel create nest-webhook
# Note the Tunnel ID (UUID) from outputCreate ~/.cloudflared/config.yml:
tunnel: nest-webhook
credentials-file: /home/YOUR_USER/.cloudflared/TUNNEL_ID.json
ingress:
- hostname: nest.yourdomain.com
service: http://localhost:8420
- service: http_status:404Create DNS route:
~/.local/bin/cloudflared tunnel route dns nest-webhook nest.yourdomain.comWebhook server (/etc/systemd/system/nest-webhook.service):
[Unit]
Description=Nest Pub/Sub Webhook Server
After=network.target
[Service]
Type=simple
User=YOUR_USER
Environment=CLAWDBOT_GATEWAY_URL=http://localhost:18789
Environment=CLAWDBOT_HOOKS_TOKEN=your-hooks-token-here
ExecStart=/usr/bin/python3 /path/to/skills/nest-devices/scripts/nest-webhook.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.targetCloudflare tunnel (/etc/systemd/system/cloudflared-nest.service):
[Unit]
Description=Cloudflare Tunnel for Nest Webhook
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=YOUR_USER
ExecStart=/home/YOUR_USER/.local/bin/cloudflared tunnel run nest-webhook
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.targetEnable and start:
sudo systemctl daemon-reload
sudo systemctl enable --now nest-webhook cloudflared-nestgcloud pubsub subscriptions create nest-events-sub \
--topic=nest-events \
--push-endpoint="https://nest.yourdomain.com/nest/events" \
--ack-deadline=30# Test webhook endpoint
curl https://nest.yourdomain.com/health
# Simulate doorbell event
curl -X POST http://localhost:8420/nest/events \
-H "Content-Type: application/json" \
-d '{"message":{"data":"eyJyZXNvdXJjZVVwZGF0ZSI6eyJuYW1lIjoiZW50ZXJwcmlzZXMvdGVzdC9kZXZpY2VzL0RPT1JCRUxMLTAxIiwiZXZlbnRzIjp7InNkbS5kZXZpY2VzLmV2ZW50cy5Eb29yYmVsbENoaW1lLkNoaW1lIjp7ImV2ZW50SWQiOiJ0ZXN0In19fX0="}}'| Event | Behaviour |
|-------|-----------|
| DoorbellChime.Chime | š Alerts ā sends photo to Telegram |
| CameraPerson.Person | š¶ Alerts ā sends photo to Telegram |
| CameraMotion.Motion | š¹ Logged only (no alert) |
| CameraSound.Sound | š Logged only (no alert) |
| CameraClipPreview.ClipPreview | š¬ Logged only (no alert) |
Staleness filter: Events older than 5 minutes are logged but never alerted. This prevents notification floods if queued Pub/Sub messages are delivered late.
When a doorbell or person event triggers an alert:
GenerateImage API ā fast, event-specific snapshotffmpeg (requires ffmpeg installed)| Variable | Required | Description |
|----------|----------|-------------|
| CLAWDBOT_GATEWAY_URL | No | Gateway URL (default: http://localhost:18789) |
| CLAWDBOT_HOOKS_TOKEN | Yes | Gateway hooks token for awareness notifications |
| OP_SVC_ACCT_TOKEN | Yes | 1Password service account token for Nest API credentials |
| TELEGRAM_BOT_TOKEN | Yes | Telegram bot token for sending alerts |
| TELEGRAM_CHAT_ID | Yes | Telegram chat ID to receive alerts |
| PORT | No | Webhook server port (default: 8420) |
projects/YOUR_GCP_PROJECT_ID/topics/nest-eventsGenerated Mar 1, 2026
A service that automatically adjusts home temperatures based on occupancy and time of day, using Nest thermostats to optimize energy usage. It integrates with user schedules to set eco modes when away and comfortable temperatures upon return, reducing utility bills.
Property managers use Nest cameras and doorbells to monitor rental properties remotely, checking for unauthorized access or maintenance issues. They can view live camera feeds and receive real-time alerts for doorbell rings or motion, enhancing security and tenant support.
Caregivers set up Nest devices to monitor elderly individuals living independently, using thermostats to maintain safe temperatures and cameras to check on daily activities. Real-time alerts for unusual motion or doorbell events provide peace of mind and quick response.
Consultants analyze Nest thermostat data to provide recommendations for reducing energy consumption in homes or small businesses. They use temperature schedules and eco modes to demonstrate cost savings and help clients meet sustainability goals.
Security companies integrate Nest cameras and doorbells into broader home security systems, offering live streaming and event alerts via Pub/Sub. This allows for centralized monitoring and automated responses to incidents like break-ins or package deliveries.
Charge a monthly fee for continuous monitoring of Nest devices, including automated temperature adjustments and real-time alerts for security events. Revenue comes from tiered plans offering different levels of automation and support.
Offer a service to set up Nest devices and configure automation scripts for clients, including OAuth integration and Pub/Sub for real-time events. Revenue is generated through fixed fees for installation and personalized consulting sessions.
Develop and sell custom integrations of the Nest API into existing smart home platforms or business applications, such as property management software. Revenue comes from licensing fees or development contracts for tailored solutions.
š¬ Integration Tip
Ensure secure storage of OAuth credentials using 1Password or environment variables, and set up Cloudflare tunnels properly for real-time Pub/Sub webhooks to avoid downtime.
Control Sonos speakers (discover/status/play/volume/group).
Control Philips Hue lights/scenes via the OpenHue CLI.
Control Eight Sleep pods (status, temperature, alarms, schedules).
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Control Home Assistant smart home devices, run automations, and receive webhook events. Use when controlling lights, switches, climate, scenes, scripts, or any HA entity. Supports bidirectional communication via REST API (outbound) and webhooks (inbound triggers from HA automations).
Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.