LG Washer MCP Server
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
제공되는 도구
도구 | 기능 |
| 세탁기의 |
| 내 모델에서 제어 가능한 속성/값을 확인합니다. |
| 실시간 상태: 실행 중 여부, 코스, 남은 시간. |
|
|
| 모델별 속성에 대한 임의의 제어 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-mcpClaude 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 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