LG Washer MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LG Washer MCP Server what's the status of my washer?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Find your washer's |
| See the controllable properties/values for your model. |
| Live state: running?, cycle, time remaining. |
|
|
| 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 PATRun 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-mcpWire 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-mcpQuick 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 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