Skip to main content
Glama
LG Washer MCP Server

LG Washer MCP Server

by madhukeshm

LG Waschmaschinen-MCP-Server

Ein MCP-Server, der es einem KI-Assistenten ermöglicht, eine LG ThinQ-Waschmaschine über die offizielle ThinQ Connect-API von LG zu überwachen und zu steuern.

Er kommuniziert direkt über HTTP mit der REST-API (ohne LG SDK). Ihr Personal Access Token (PAT) wird als Bearer-Token verwendet.

So funktioniert die API (die Kurzversion)

  • Auth: Authorization: Bearer <PAT>. Kein OAuth-Ablauf.

  • Region: Ihr Ländercode bestimmt den Server. Indien (IN) → https://api-kic.lgthinq.com.

  • Jede Anfrage sendet außerdem x-country, x-client-id (eine UUID4 Ihrer Wahl), x-api-key (einen öffentlichen Schlüssel), x-message-id (frisch pro Anfrage), x-service-phase: OP.

  • Endpunkte: GET /devices, GET /devices/{id}/profile, GET /devices/{id}/state, POST /devices/{id}/control.

Related MCP server: SmartThings MCP Server

Verfügbare Tools

Tool

Was es tut

list_devices

Findet die deviceId Ihrer Waschmaschine.

get_washer_profile

Zeigt die steuerbaren Eigenschaften/Werte für Ihr Modell.

get_washer_status

Live-Status: läuft?, Programm, verbleibende Zeit.

control_washer

START / STOP / WAKE_UP.

control_washer_raw

Sendet ein beliebiges Steuer-JSON für modellspezifische Eigenschaften.

⚠️ Die meisten LG-Waschmaschinen akzeptieren einen Remote-START nur, wenn das Gerät physisch auf „Remote Start" eingestellt ist und bereits ein Programm geladen ist. Die API setzt ein vorausgewähltes Programm fort/startet es; sie kann normalerweise kein Waschprogramm von Grund auf auswählen.

Einrichtung

uv sync
cp .env.example .env   # then edit .env with your PAT

Ausführen

Die Konfiguration wird aus Umgebungsvariablen gelesen (THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID). Der Server spricht MCP über stdio.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

In Claude Desktop / Claude Code einbinden

Fügen Sie Folgendes zu Ihrer MCP-Konfiguration hinzu (z. B. claude_desktop_config.json):

{
  "mcpServers": {
    "lg-washer": {
      "command": "uv",
      "args": ["--directory", "/Users/sushmanagaraj/c_drive/Coding/LG", "run", "washer-mcp"],
      "env": {
        "THINQ_PAT": "your-pat-here",
        "THINQ_COUNTRY": "IN",
        "THINQ_CLIENT_ID": "your-uuid4-here"
      }
    }
  }
}

Speziell für Claude Code:

claude mcp add lg-washer --env THINQ_PAT=xxx --env THINQ_COUNTRY=IN -- uv --directory /Users/sushmanagaraj/c_drive/Coding/LG run washer-mcp

Schneller manueller Test (kein MCP-Client erforderlich)

uv run python -c "import asyncio, os; from washer_mcp.thinq_client import ThinQClient; \
print(asyncio.run(ThinQClient(os.environ['THINQ_PAT'],'IN',os.environ.get('THINQ_CLIENT_ID','test-id')).list_devices()))"

Available Tools

5 tools
control_washerA

Start, stop, power off, or wake the washer.

operation must be one of: START, STOP, POWER_OFF, WAKE_UP. location is the device zone from the profile (default "MAIN"). Location- scoped washers reject commands that omit it (API error code 2207).

Note: most LG washers only accept a remote START when the machine has been physically set to "Remote Start" and a cycle is already selected/loaded. The API pauses/resumes or starts a pre-selected cycle; it generally cannot pick a wash program from scratch. Call get_washer_profile first to confirm the model supports the operation and to see the exact accepted values.

Inputs: device_id (required), operation (required), location. Returns: result

control_washer_rawA

Escape hatch: send an arbitrary control payload to the washer.

control_json is a JSON object matching the shape shown in the device profile, e.g. {"operation": {"washerOperationMode": "START"}}. Use this for model-specific properties (timers, remote-control toggles, etc.) that the higher-level tools do not cover.

Inputs: device_id (required), control_json (required). Returns: result

get_washer_profileA

Get a washer's capability profile: the exact controllable properties and their allowed values for THIS specific model. Consult this before controlling, because property names/values vary by model.

Inputs: device_id (required). Returns: result

get_washer_statusA

Get the washer's current live state: whether it is running, the current cycle/run state, and remaining time.

Inputs: device_id (required). Returns: result

list_devicesA

List all LG ThinQ devices on the account. Use this to find the washer's deviceId, which every other tool needs.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 5 tools

    Disambiguation4/5

    Most tools are clearly distinct: listing devices, fetching profile, fetching status, and sending commands all serve different purposes. The only mild overlap is between control_washer and control_washer_raw, but the descriptions make the intended boundary clear.

    Naming Consistency5/5

    All tools follow a clean snake_case verb_noun pattern: list_devices, get_washer_profile, get_washer_status, control_washer, control_washer_raw. The naming is consistent and predictable.

    Tool Count5/5

    Five tools is well-scoped for an LG washer MCP server: discovery, model introspection, status, high-level control, and a raw escape hatch. Each tool earns its place without adding redundancy.

    Completeness4/5

    The server covers the core washer workflow: find the device, inspect its capability profile, read live status, and issue commands. The raw control tool helps fill model-specific gaps, though common operations like pause/resume are not explicitly exposed beyond the raw payload path.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to control DeLonghi ECAM espresso machines over a local network, including brewing beverages, monitoring status, and managing machine settings.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to monitor a Hyundai, Kia, or Genesis vehicle's charge, fuel, range, locks, and location, and optionally pre-heat the cabin, lock or unlock doors, and start or stop charging. Reads come from cached Bluelink data with rate-limited refreshes, and all write commands are disabled by default.
      23
      2
      MIT