dyson-cli

Control Dyson air purifiers, fans, and heaters via local MQTT. Use when asked to control Dyson devices, adjust fan speed, set temperature/heat, enable oscillation, or check room temperature/humidity. Requires being on the same WiFi network as the device.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

This Claude skill provides a robust command-line interface for controlling Dyson air purifiers, fans, and heaters via local MQTT. It solves the problem of manual hardware management by allowing users to adjust fan speeds, set precise temperatures, toggle oscillation, and monitor indoor air quality (temperature and humidity) through natural language, ensuring a seamless smart home integration without relying on external cloud APIs.

Use Cases

  • Smart Climate Control: Adjust heating targets and fan speeds on Dyson Hot+Cool models using simple voice or text commands like 'Set the bedroom temperature to 22 degrees'.
  • Environmental Monitoring: Quickly check real-time room temperature and humidity levels to maintain optimal indoor air quality.
  • Automated Comfort Routines: Execute complex sequences such as enabling night mode and gentle oscillation simultaneously for a better sleep environment.
  • Multi-Room Management: Target specific Dyson devices across different rooms (e.g., 'Office' vs 'Living Room') using unique device identifiers for localized control.
  • Hands-Free Operation: Control fan oscillation angles and auto-mode settings without needing the physical remote or the mobile app.
namedyson-cli
descriptionControl Dyson air purifiers, fans, and heaters via local MQTT. Use when asked to control Dyson devices, adjust fan speed, set temperature/heat, enable oscillation, or check room temperature/humidity. Requires being on the same WiFi network as the device.

Dyson CLI

Prerequisites

  1. CLI installed at ~/dyson-cli with venv
  2. Must be on same WiFi as the Dyson - local MQTT only, won't work remotely

Quick check:

cd ~/dyson-cli && source .venv/bin/activate && dyson list --check

Commands

Power

dyson on                      # Turn on
dyson off                     # Turn off

Fan Control

dyson fan speed 5             # Speed 1-10
dyson fan speed auto          # Auto mode
dyson fan oscillate on        # Enable oscillation
dyson fan oscillate on -a 90  # 90° sweep (45/90/180/350)
dyson fan oscillate off       # Disable oscillation

Heat Control (Hot+Cool models)

dyson heat on                 # Enable heating
dyson heat off                # Disable heating
dyson heat target 22          # Set target temp (°C)

Other

dyson night on                # Night mode on
dyson night off               # Night mode off
dyson status                  # Show current state
dyson status --json           # JSON output

Multiple Devices

Use -d <name> to target a specific device:

dyson on -d "Bedroom"
dyson fan speed auto -d "Office"

Common Patterns

# "Turn on the Dyson and set to auto"
dyson on && dyson fan speed auto

# "Heat to 23 degrees"
dyson heat on && dyson heat target 23

# "Turn on with gentle oscillation"
dyson on && dyson fan speed 3 && dyson fan oscillate on -a 45

# "What's the current temperature?"
dyson status --json | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"Temp: {d['temperature']-273:.1f}°C, Humidity: {d['humidity']}%\")"

Troubleshooting

If commands fail:

  1. Check device is online: dyson list --check
  2. Ensure on same WiFi network as the Dyson
  3. Re-run setup if credentials expired: dyson setup

For installation, device setup, and full documentation, see README.md.