Skip to main content
Glama
LG Washer MCP Server

LG Washer MCP Server

by madhukeshm

LG Washer MCP Server

MCP 서버는 AI 어시스턴트가 LG 공식 ThinQ Connect API를 통해 LG ThinQ 세탁기를 모니터링하고 제어할 수 있게 해줍니다.

REST API와 HTTP로 직접 통신합니다(LG SDK 불필요). **Personal Access Token (PAT)**이 bearer 토큰으로 사용됩니다.

API 작동 방식(간단히)

  • 인증: Authorization: Bearer <PAT>. OAuth 플로우 없음.

  • 지역: 국가 코드가 서버를 결정합니다. 인도(IN) → https://api-kic.lgthinq.com.

  • 모든 요청에는 x-country, x-client-id(직접 선택하는 UUID4), x-api-key(공개 키), x-message-id(요청마다 새로 생성), x-service-phase: OP도 함께 전송됩니다.

  • 엔드포인트: GET /devices, GET /devices/{id}/profile, GET /devices/{id}/state, POST /devices/{id}/control.

Related MCP server: SmartThings MCP Server

제공되는 도구

도구

기능

list_devices

세탁기의 deviceId를 찾습니다.

get_washer_profile

내 모델에서 제어 가능한 속성/값을 확인합니다.

get_washer_status

실시간 상태: 실행 중 여부, 코스, 남은 시간.

control_washer

START / STOP / WAKE_UP.

control_washer_raw

모델별 속성에 대한 임의의 제어 JSON을 전송합니다.

⚠️ 대부분의 LG 세탁기는 기기가 물리적으로 "Remote Start" 상태이고 코스가 이미 선택되어 있을 때만 원격 START를 허용합니다. API는 미리 선택된 코스를 재개/시작하며, 일반적으로 세탁 프로그램을 처음부터 선택할 수는 없습니다.

설정

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

실행

구성은 환경 변수(THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID)에서 읽습니다. 서버는 stdio를 통해 MCP로 통신합니다.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

Claude Desktop / Claude Code에 연결

MCP 구성에 추가하세요(예: 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"
      }
    }
  }
}

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

빠른 수동 테스트(MCP 클라이언트 불필요)

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
    ResponsivenessOutdated data

    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