MCP Dyson Appliances

🚀 mcp-dyson-appliances

An MCP (Model Context Protocol) server for controlling Dyson air purifiers and fans, enabling users to manage device states and access air quality information.

✨ Features

• get_device_status: Retrieve the current state of the device, including power, fan speed, oscillation, night mode, and air quality.
• set_fan_speed: Set the fan speed, which can be a value from 1 - 10 or set to auto.
• set_oscillation: Enable or disable the oscillation function.
• get_air_quality: Obtain detailed air quality readings, such as PM2.5, PM10, VOC, NO2, humidity, and temperature.
• set_night_mode: Enable or disable the night mode.

📦 Installation

From npm (Recommended)

npx mcp-dyson-appliances

From Source

git clone https://github.com/m2ai-mcp-servers/mcp-dyson-appliances.git
cd mcp-dyson-appliances
npm install
npm run build

🚀 Quick Start

Prerequisites

• Node.js 18+
• A Dyson account with registered devices
• Dyson devices connected to your network

Supported Devices

• Pure Cool Link (Tower & Desk)
• Pure Cool
• Pure Hot+Cool
• Pure Hot+Cool Link
• Pure Humidify+Cool
• Pure Cool Formaldehyde

Configuration

Environment Variables

export DYSON_EMAIL=your-email@example.com
export DYSON_PASSWORD=your-password
export DYSON_COUNTRY=US  # Optional, defaults to US

Supported Country Codes

• US - United States
• GB - United Kingdom
• DE - Germany
• FR - France
• AU - Australia
• CN - China

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "dyson": {
      "command": "npx",
      "args": ["-y", "mcp-dyson-appliances"],
      "env": {
        "DYSON_EMAIL": "your-email@example.com",
        "DYSON_PASSWORD": "your-password",
        "DYSON_COUNTRY": "US"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Get device status

get_device_status

Returns:

{
  "device": {
    "serial": "ABC-XX-XXXXXXXX",
    "name": "Living Room"
  },
  "state": {
    "power": "on",
    "fanSpeed": "5",
    "oscillation": "on",
    "nightMode": "off",
    "autoMode": "off"
  },
  "airQuality": {
    "pm25": 8,
    "pm10": 12,
    "voc": 2,
    "no2": 1,
    "humidity": "45%",
    "temperature": "22.5°C",
    "level": "Good"
  }
}

Set fan speed

set_fan_speed speed="5"
set_fan_speed speed="auto"
set_fan_speed device_id="ABC-XX-XXXXXXXX" speed="10"

Set oscillation

set_oscillation enabled=true
set_oscillation device_id="ABC-XX-XXXXXXXX" enabled=false

Get air quality

get_air_quality

Returns:

{
  "pm25": {
    "value": 8,
    "unit": "µg/m³",
    "level": "Good"
  },
  "pm10": {
    "value": 12,
    "unit": "µg/m³"
  },
  "voc": {
    "value": 2,
    "unit": "index",
    "description": "Low"
  },
  "no2": {
    "value": 1,
    "unit": "index",
    "description": "Low"
  },
  "humidity": {
    "value": 45,
    "unit": "%",
    "description": "Comfortable"
  },
  "temperature": {
    "celsius": 22.5,
    "fahrenheit": 73
  }
}

Set night mode

set_night_mode enabled=true
set_night_mode device_id="ABC-XX-XXXXXXXX" enabled=false

📚 Documentation

Air Quality Index (AQI) Levels

Based on PM2.5 readings:

🔧 Technical Details

Development

# Watch mode
npm run dev

# Run tests
npm test

# Build
npm run build

Testing

npm test

Troubleshooting

Authentication Failed

• Verify that your Dyson email and password are correct.
• Ensure that your account has registered devices.
• Check if your country code is correct.

Device Not Found

• Ensure that the devices are powered on and connected to WiFi.
• Check if the devices appear in the Dyson Link app.
• Try specifying the device serial number directly.

Air Quality Not Available

• Some older devices may not have air quality sensors.
• Ensure that the device supports air quality monitoring.

📄 License

MIT

Built autonomously by GRIMLOCK - Autonomous MCP Server Factory