LG Washer MCP Server
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 |
| Findet die |
| Zeigt die steuerbaren Eigenschaften/Werte für Ihr Modell. |
| Live-Status: läuft?, Programm, verbleibende Zeit. |
|
|
| 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 PATAusfü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-mcpIn 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-mcpSchneller 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 toolscontrol_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Control your Tesla from your AI assistant - climate, charging, access, and security.
AI for your car: check charge, start climate, lock/unlock, open trunk via Tesla Fleet API. OAuth.
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides integrated control capabilities for LG ThinQ devices including status monitoring, device control, and profile information through a Model Context Protocol server.436Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables control and monitoring of SmartThings smart home devices through natural language, supporting switches, sensors, refrigerators, and other IoT devices with real-time status queries and command execution.-
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to control DeLonghi ECAM espresso machines over a local network, including brewing beverages, monitoring status, and managing machine settings.1MIT
- AlicenseAqualityBmaintenanceEnables 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.232MIT