ThinQ Connect

ThinQ Connect

Interact with LG ThinQ smart home devices and appliances through the ThinQ Connect MCP server.

18
Stars
2
Forks
2
Releases

Overview

The ThinQ Connect MCP Server is the official MCP server for LG ThinQ devices, enabling integrated control capabilities via the Model Context Protocol. It provides features for querying the list of registered ThinQ devices, obtaining real-time status information for specific devices, executing device control commands defined in each device’s profile (e.g., power on/off, set temperature), and retrieving detailed information about controllable properties and methods for each device, including profile information. Built on the LG ThinQ API and Python Open SDK, the server communicates via an MCP connection using stdio, allowing Claude or other MCP clients to send prompts and receive structured responses. It exposes tools such as get_device_list, get_device_status, get_device_available_controls, and post_device_control to perform operations, and is designed to be integrated into conversational workflows. Prerequisites include a personal access token, verified country code, Python 3.11+, uv package, and an MCP client. Quick Start demonstrates configuring Claude Desktop by mapping an MCP entry to run the server with THINQ_PAT and THINQ_COUNTRY environment variables.

Details

Owner
thinq-connect
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Device List Query

Retrieve a list of all registered LG ThinQ devices.

Device Status Monitoring

Get real-time status information for specific devices.

Device Control

Execute control commands defined in each device's profile (e.g., power on/off, set temperature).

Device Control Capabilities Query

Provide detailed information about controllable properties and methods for each device.

Audience

DevelopersIntegrate ThinQ device control into MCP-enabled chat workflows using Claude.
HomeownersControl and monitor home LG ThinQ devices via natural language prompts.

Tags

LG ThinQMCPSmart HomeIoTDevice ControlDevice StatusDevice ListPythonOpen SDK