mcp-dyson-appliances

An MCP (Model Context Protocol) server for controlling Dyson air purifiers and fans.

# Features

• get_device_status - Get current device state (power, fan speed, oscillation, night mode, air quality)
• set_fan_speed - Set fan speed (1-10 or auto)
• set_oscillation - Enable/disable oscillation
• get_air_quality - Get detailed air quality readings (PM2.5, PM10, VOC, NO2, humidity, temperature)
• set_night_mode - Enable/disable night mode

# Prerequisites

• Node.js 18+
• 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

# 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

# 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 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

# # 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

# Air Quality Index (AQI) Levels

Based on PM2.5 readings:

| PM2.5 (µg/m³) | Level |
|- -- -- -- -- -- -- --|- -- -- --|
| 0-12 | Good |
| 13-35 | Moderate |
| 36-55 | Unhealthy for Sensitive Groups |
| 56-150 | Unhealthy |
| 151-250 | Very Unhealthy |
| 251+ | Hazardous |

# Development

#  Watch mode
npm run dev

#  Run tests
npm test

#  Build
npm run build

# Testing

npm test

# Troubleshooting

# # Authentication Failed

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

# # Device Not Found

• Ensure devices are powered on and connected to WiFi
• Check if 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 the device supports air quality monitoring

# Security Notes

• Credentials are passed via environment variables (never hardcode)
• The server uses HTTPS for all API communication
• Consider using a secrets manager in production

# License

MIT

Built autonomously by GRIMLOCK - Autonomous MCP Server Factory