Skip to main content
Glama
LG Washer MCP Server

LG Washer MCP Server

by madhukeshm

LG Washer MCP Server

AIアシスタントがLGの公式ThinQ Connect APIを通じてLG ThinQ洗濯機を監視・制御できるようにするMCPサーバーです。

REST APIと直接HTTPで通信します(LG SDKは不要)。Personal Access Token (PAT) がベアラートークンとして使用されます。

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

公開ツール

Tool

説明

list_devices

洗濯機のdeviceIdを見つけます。

get_washer_profile

お使いのモデルの制御可能なプロパティ/値を確認します。

get_washer_status

ライブ状態:実行中?、サイクル、残り時間。

control_washer

START / STOP / WAKE_UP。

control_washer_raw

モデル固有のプロパティに対して任意の制御JSONを送信します。

⚠️ ほとんどのLG洗濯機は、機械が物理的に「リモートスタート」に設定され、サイクルがすでにロードされている場合にのみ、リモート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
    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