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.

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()))"