MCP Dyson Appliances Server

This MCP server lets you control Dyson air purifiers and fans through a standardized, programmable interface. You can fetch device status, adjust fan speed and oscillation, read detailed air quality data, and toggle night mode, all via simple MCP client commands.

How to use

To use this server, run it from your MCP client environment. The server exposes a set of practical commands you can invoke to monitor and control your Dyson devices. Typical workflows include checking current device status, changing fan speed, turning oscillation on or off, retrieving air quality readings, and enabling or disabling night mode. Use these commands in your MCP client as you would with other MCP endpoints.

How to install

Prerequisites you need before installation:

• Node.js 18+

• A valid Dyson account with registered devices

• Dyson devices connected to your network

Choose one of the installation methods below and follow the steps in order.

# 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 to configure the server with your Dyson account data.

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

Supported country codes

Use the country code that matches your Dyson account country. Current supported codes include US, GB, DE, FR, AU, and CN.

Claude Desktop Configuration

To integrate with Claude Desktop, add the following MCP server entry 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

Once the server is running, you can issue commands from your MCP client to interact with your Dyson devices. Examples of supported actions include getting device status, setting fan speed, toggling oscillation, retrieving air quality data, and enabling or disabling night mode.

Air Quality Index (AQI) guidance

Air quality readings use PM2.5 measurements to categorize air conditions. Refer to the supported ranges in your client outputs to assess air quality quickly.

Development

Common development commands you might run during work with this server include watching for changes, running tests, and building the distribution.

# Watch mode
npm run dev

# Run tests
npm test

# Build
npm run build

Troubleshooting

If you encounter issues, check that your Dyson email and password are correct, confirm your account has registered devices, and verify the country code matches your account. If a device does not appear, ensure it is powered on and connected to WiFi and try specifying the device serial directly.

Security Notes

Credentials are supplied via environment variables and never hardcoded in the source. The server communicates over HTTPS for all API interactions. In production, consider using a secrets manager to protect sensitive information.

License

MIT license.

Available tools

get_device_status

Fetches the current state of a configured Dyson device, including power, fan speed, oscillation, night mode, and auto mode.

set_fan_speed

Sets the device fan speed from 1 to 10 or switches to auto mode.

set_oscillation

Enables or disables the oscillation feature of the device.

get_air_quality

Retrieves detailed air quality readings such as PM2.5, PM10, VOC, NO2, humidity, and temperature.

set_night_mode

Enables or disables night mode on the device.