ThinQ Connect

Provides device listing, status monitoring, and control capabilities for LG ThinQ devices via MCP using the ThinQ Open API.

python

18

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thinq-connect-thinqconnect-mcp": {
      "command": "uvx",
      "args": [
        "thinqconnect-mcp"
      ],
      "env": {
        "THINQ_PAT": "your_personal_access_token_here",
        "THINQ_COUNTRY": "your_country_code_here"
      }
    }
  }
}

The ThinQ Connect MCP Server provides programmatic access to LG ThinQ devices, enabling you to query devices, monitor status, and issue controls through a standardized MCP interface. It runs locally via stdio and interacts with the ThinQ API, making it possible to automate device actions in conversations and scripts.

How to use

You use this MCP server by starting it through your MCP client and then invoking its available tools to list devices, check statuses, query controllable actions, and send device commands. Typical workflows include retrieving all registered devices, checking a specific device’s status, learning what controls a device supports, and issuing a control command such as turning a device on or adjusting a setting.

How to install

Prerequisites include preparing a Personal Access Token for ThinQ Open API calls, verifying your ThinQ country code, and ensuring you have Python 3.11 or higher and the uv tool installed. You also need an MCP client such as Claude Desktop.

Then configure and run the MCP server as described in the Quick Start configuration snippet.

{
  "mcpServers": {
    "thinqconnect-mcp": {
      "command": "uvx",
      "args": [
        "thinqconnect-mcp"
      ],
      "env": {
          "THINQ_PAT": "your_personal_access_token_here",
          "THINQ_COUNTRY": "your_country_code_here"
      }
    }
  }
}

Additional sections

Prerequisites details and how to start the MCP server are provided below so you can set up quickly and securely. You will use your MCP client to connect to the local stdio server and perform device queries and controls via the available tools.

Security tip: keep your ThinQ Personal Access Token confidential and scope it to only what you need for your automations. Store your token in environment variables or a secure secret manager and reference it in your MCP client configuration.

Tool reference

The server exposes a set of tools you can invoke from your MCP client to interact with LG ThinQ devices.

Available tools

get_device_list

Retrieves a list of all devices connected to the ThinQ Connect platform

get_device_available_controls

Retrieves available control commands and parameter information for a specific device

get_device_status

Retrieves status information for a specific device

post_device_control

Sends control commands to a specific device to change its settings or state