Skip to main content
Glama
LG Washer MCP Server

LG Washer MCP Server

by madhukeshm

LG Washer MCP Server

An MCP server that lets an AI assistant monitor and control an LG ThinQ washing machine through LG's official ThinQ Connect API.

It talks to the REST API directly over HTTP (no LG SDK). Your Personal Access Token (PAT) is used as a bearer token.

How the API works (the short version)

  • Auth: Authorization: Bearer <PAT>. No OAuth flow.

  • Region: your country code picks the server. India (IN) → https://api-kic.lgthinq.com.

  • Every request also sends x-country, x-client-id (a UUID4 you choose), x-api-key (a public key), x-message-id (fresh per request), x-service-phase: OP.

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

Related MCP server: SmartThings MCP Server

Tools exposed

Tool

What it does

list_devices

Find your washer's deviceId.

get_washer_profile

See the controllable properties/values for your model.

get_washer_status

Live state: running?, cycle, time remaining.

control_washer

START / STOP / WAKE_UP.

control_washer_raw

Send an arbitrary control JSON for model-specific properties.

⚠️ Most LG washers only accept a remote START when the machine is physically set to "Remote Start" with a cycle already loaded. The API resumes/starts a pre-selected cycle; it usually can't pick a wash program from scratch.

Setup

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

Run it

Configuration is read from environment variables (THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID). The server speaks MCP over stdio.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

Wire into Claude Desktop / Claude Code

Add to your MCP config (e.g. 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"
      }
    }
  }
}

For Claude Code specifically:

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

Quick manual test (no MCP client needed)

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