Home Controller - Smart Home MCP Integration

A unified home automation system for controlling Miele, LG ThinQ, HUUM Sauna, and Phyn Water Monitor appliances through Claude Code using the Model Context Protocol (MCP).

Features

Miele Integration (Custom Node.js MCP Server)

• Get list of all connected Miele devices

• Get detailed status of any device (oven, refrigerator, freezer, etc.)

• Control devices (start, stop, pause, power on/off)

• Real-time device monitoring

LG ThinQ Integration (Official Python MCP Server)

• Control LG washers and dryers

• Monitor device status in real-time

• Get device capabilities and available programs

• Subscribe to device events

HUUM Sauna Integration (Custom Node.js MCP Server)

• Monitor sauna temperature and status

• Start and stop sauna heating remotely

• Set target temperature (40-110°C)

• Control sauna lighting

• Check door state and safety status

Phyn Water Monitor Integration (Custom Node.js MCP Server)

• Monitor water pressure, temperature, and flow rate

• Get historical water consumption data (daily/monthly/yearly)

• Control main water shutoff valve (Phyn Plus)

• Support for multiple Phyn devices (Plus and Smart Sensors)

• Perfect for building water usage reports

Slash Commands

• /laundry-status - Quick check on washers and dryers

• /kitchen-status - Check all Miele kitchen appliances

• /sauna-status - Check HUUM sauna status

• /home-status - Complete overview of all devices

• /start-washer - Interactive washer control

• /start-dryer - Interactive dryer control

• /start-sauna - Interactive sauna control

• /stop-sauna - Turn off the sauna

• /check-alerts - Check for notifications and alerts

• /water-status - Check water system pressure and flow

• /water-report - Get water consumption report

Prerequisites

1. For Miele:

   • Miele account with connected appliances

   • Miele Developer Portal credentials (Client ID and Client Secret)

   • Node.js v18+ installed

2. For LG ThinQ:

   • LG ThinQ account with connected appliances

   • LG ThinQ Personal Access Token (PAT)

   • Python 3.11+ installed

3. For HUUM Sauna:

   • HUUM sauna with UKU WiFi controller

   • HUUM mobile app account

   • Node.js v18+ installed

4. For Phyn Water Monitor:

   • Phyn Plus and/or Phyn Smart Water Sensors

   • Phyn mobile app account

   • Node.js v18+ installed

Setup

Miele Setup

Step 1: Get Miele API Credentials

1. Go to Miele Developer Portal

2. Create an account or log in

3. Create a new application

4. Add redirect URI: http://localhost:3000/callback

5. Note your Client ID and Client Secret

Step 2: Configure Miele Environment

1. Edit .env and add your credentials:

   MIELE_CLIENT_ID=your_client_id_here MIELE_CLIENT_SECRET=your_client_secret_here

Step 3: Authenticate with Miele

Run the authentication helper:

Important for US Users:

• The auth script uses the legacy OAuth endpoint (api.mcs3.miele.com)

• This is required for US Miele accounts

• EU users may need different endpoint configuration

This will:

1. Open your browser to authenticate with Miele

2. Exchange the authorization code for an access token

3. Save the token to your .env file (valid for 30 days)

LG ThinQ Setup

Step 1: Get LG ThinQ Personal Access Token

1. Go to LG ThinQ Developer Portal

2. Create an account or log in

3. Navigate to the PAT (Personal Access Token) section

4. Generate a new token with these permissions:

   • View all devices and statuses

   • Device control and event subscription

   • Device push notifications

   • Energy consumption inquiry

Step 2: Configure LG ThinQ Environment

1. Edit .env and add your credentials:

   THINQ_PAT=your_personal_access_token_here THINQ_COUNTRY=US

Step 3: Install LG ThinQ MCP Server

The LG ThinQ MCP server is already installed via pipx:

HUUM Sauna Setup

Step 1: Get HUUM Account Credentials

1. Download the HUUM mobile app (iOS/Android)

2. Create an account or log in

3. Connect your HUUM sauna with UKU WiFi controller

4. Note your login credentials (email and password)

Step 2: Configure HUUM Environment

1. Edit .env and add your credentials:

   HUUM_USERNAME=your_email@example.com HUUM_PASSWORD=your_password_here

Note: The HUUM API uses Basic Authentication with the same credentials you use in the mobile app.

Step 3: Install Dependencies

The HUUM MCP server uses the same Node.js dependencies as the Miele server:

Phyn Water Monitor Setup

Step 1: Get Phyn Account Credentials

1. Download the Phyn mobile app (iOS/Android)

2. Create an account or log in

3. Connect your Phyn devices (Plus or Smart Sensors)

4. Note your login credentials (email and password)

Step 2: Configure Phyn Environment

1. Edit .env and add your credentials:

   PHYN_USERNAME=your_email@example.com PHYN_PASSWORD=your_password_here PHYN_API_KEY=E7nfOgW6VI64fYpifiZSr6Me5w1Upe155zbu4lq8

Note: The Phyn API uses AWS Cognito authentication with the same credentials you use in the mobile app. The API key is a public key used by the Phyn service.

Step 3: Install Dependencies

The Phyn MCP server uses the same Node.js dependencies plus the Cognito library:

Testing Your Setup

Test Miele Integration

Test LG ThinQ Integration

Test HUUM Sauna Integration

This will:

1. Initialize the HUUM MCP server

2. List available tools

3. Get current sauna status (temperature, door state, etc.)

Test Phyn Water Monitor Integration

This will:

1. Initialize the Phyn MCP server

2. List available tools

3. Get all Phyn devices

4. Get current device status (pressure, temperature, flow)

5. Get water consumption data

Available Tools

Miele MCP Server

get_devices

Get all Miele devices connected to your account.

get_device_status

Get detailed status for a specific device.

• Parameters: deviceId (string)

device_action

Perform an action on a device.

• Parameters:

  • deviceId (string)

  • action (string): one of "start", "stop", "pause", "powerOn", "powerOff"

LG ThinQ MCP Server

The official LG ThinQ MCP server provides:

• Device list query

• Device status monitoring

• Device control (start, stop, settings)

• Device capabilities query

See thinqconnect-mcp documentation for full details.

HUUM Sauna MCP Server

get_sauna_status

Get current status of the HUUM sauna including:

• Current temperature

• Target temperature

• Heater on/off state

• Door state (open/closed)

• Humidity level

• Start/end times

start_sauna

Start the sauna and set target temperature.

• Parameters:

  • targetTemperature (number): Target temperature in Celsius (40-110)

• Safety: Always verifies door is closed before starting

stop_sauna

Stop/turn off the sauna heater.

toggle_light

Toggle the sauna light on/off.

Phyn Water Monitor MCP Server

get_devices

Get all Phyn devices connected to your account (Phyn Plus and Smart Sensors).

get_device_status

Get detailed status for a specific device.

• Parameters: device_id (string)

• Returns: pressure, temperature, flow rate, valve status, online status

get_consumption

Get historical water consumption data.

• Parameters:

  • device_id (string)

  • duration (string): YYYY/MM/DD for daily, YYYY/MM for monthly, YYYY for yearly

shutoff_valve

Open or close the main water shutoff valve (Phyn Plus only).

• Parameters:

  • device_id (string)

  • action (string): "open" or "close"

Using with Claude Code

Project-Level Configuration (Recommended)

The .mcp.json file in this directory configures all four servers:

Note: Wrapper scripts automatically load environment variables from .env.

Global Configuration

To use these servers from anywhere, copy the config:

Then restart Claude Code.

Slash Commands

Slash commands are available in .claude/commands/:

• /laundry-status - Quick status check for washers/dryers

• /kitchen-status - Check all Miele kitchen appliances

• /sauna-status - Check HUUM sauna temperature and status

• /home-status - Dashboard view of all appliances

• /start-washer - Interactive washer program selection

• /start-dryer - Interactive dryer program selection

• /start-sauna - Interactive sauna control with temperature

• /stop-sauna - Turn off the sauna

• /check-alerts - View notifications and completed cycles

• /water-status - Check water pressure and flow

• /water-report - Get water consumption report

Example Usage

Once configured in Claude Code, you can use natural language:

Troubleshooting

Miele Issues

"401 Unauthorized" errors

• Your access token has expired (tokens last 30 days)

• Run npm run auth to get a new token

Device not responding

• Ensure device is powered on and connected to WiFi

• Verify the device supports Miele@mobile app

• Check that remote control is enabled on the device

US Region Issues

• US accounts must use the legacy OAuth endpoint

• The auth script is pre-configured for US accounts

• EU users may need to modify auth.js to use the new endpoint

LG ThinQ Issues

PAT not working

• Verify your PAT at https://thinq.developer.lge.com

• Check that all required permissions are granted

• Ensure THINQ_COUNTRY matches your account region

Server not found

• Verify pipx installation: which thinqconnect-mcp

• Check PATH includes ~/.local/bin

• Run pipx ensurepath if needed

HUUM Sauna Issues

"401 Unauthorized" or authentication errors

• Verify your HUUM credentials in .env

• Ensure you're using the same email/password as the HUUM mobile app

• Try logging out and back into the HUUM app to verify credentials

Sauna not responding

• Check that the UKU WiFi controller is powered on and connected

• Verify the sauna is online in the HUUM mobile app

• Ensure your HUUM account is connected to the sauna

Cannot start sauna remotely

• The sauna door must be closed for safety

• Check door state with /sauna-status before starting

• Verify remote safety state is not disabled

Temperature not updating

• The sauna may be off or cooling down (shows low temperature like 2°C)

• Start the sauna to see temperature changes

• Check that the heater is functioning properly

Phyn Water Monitor Issues

"401 Unauthorized" or authentication errors

• Verify your Phyn credentials in .env

• Ensure you're using the same email/password as the Phyn mobile app

• Check that PHYN_API_KEY is set correctly

Devices not showing

• Make sure your Phyn devices are online in the Phyn app

• Verify your Phyn account has devices registered

• Check WiFi connectivity on your Phyn devices

Water consumption not loading

• The Phyn Plus is required for consumption data

• Smart Water Sensors (PW1) don't provide consumption data

• Try different duration formats: YYYY/MM/DD, YYYY/MM, or YYYY

Cannot control shutoff valve

• Only Phyn Plus (PP2) devices have shutoff capability

• Smart Water Sensors (PW1) are monitoring-only

• Ensure the valve is not manually locked

MCP Server Issues

Servers not loading in Claude Code

• Verify .mcp.json is in the correct location

• Check that all environment variables are set in .env

• Restart Claude Code after configuration changes

• Review Claude Code logs for errors

Token Maintenance

Miele Token Refresh

Miele access tokens expire after 30 days. When expired:

LG ThinQ PAT

LG Personal Access Tokens don't expire unless revoked. No maintenance needed.

HUUM Credentials

HUUM uses your mobile app login credentials. No token refresh needed - credentials remain valid as long as your account is active.

Phyn Credentials

Phyn uses AWS Cognito authentication with your mobile app login credentials. Tokens are automatically refreshed by the MCP server. No manual maintenance needed.

Project Structure

Security Notes

• ✅ Credentials stored in .env (not committed to git)

• ✅ .mcp.json references environment variables

• ✅ .gitignore prevents accidental credential commits

• ✅ Tokens are stored locally, never transmitted to Claude

Resources

Miele

• Miele Developer Portal

• Miele API Documentation

• Miele USA Support

LG ThinQ

• LG ThinQ Developer Portal

• LG ThinQ MCP Server

• PyPI Package

HUUM Sauna

• HUUM Mobile App (iOS/Android)

• HUUM UKU WiFi Controller

• HUUM Support

• PyHuum Library (Python API reference)

Phyn Water Monitor

• Phyn Mobile App (iOS/Android)

• Phyn Plus

• Phyn Smart Water Sensor

• aiophyn Library (Python API reference)

General

• Model Context Protocol

• Claude Code Documentation

Contributing

This is a personal home automation project. Feel free to fork and customize for your own setup!

License

ISC

Support

For issues:

• Miele API: Contact partner.developer@miele.com

• LG ThinQ API: Check the LG Developer Portal

• MCP/Claude Code: See Claude Code documentation