ThinQ Connect MCP Server (Beta)

1![Local Image](https://www.lge.co.kr/kr/main/thinq/images/main/thinq_logo.png)
2 
3 
4# ThinQ Connect MCP Server (Beta)
5This is the official MCP (Model Context Protocol) server for LG ThinQ devices.
6This server provides integrated control capabilities including status monitoring, device control, and profile information for various LG ThinQ devices, built on the LG ThinQ API and Python Open SDK. MCP connection method is stdio.
7 
8![ThinQ Connect MCP Demo](demo.gif)
9 
10## Table of Contents
11 
12 
13- [Features](#features)
14- [Prerequisites](#prerequisites)
15- [Quick Start](#quick-start)
16- [Detailed Usage](#detailed-usage)
17- [Tool Reference](#tool-reference)
18 
19 
20## Features
21 
22- **Device List Query**  
23  Retrieve a list of all registered LG ThinQ devices.
24 
25- **Device Status Monitoring**  
26  Get real-time status information for specific devices.
27 
28- **Device Control**  
29  Execute control commands defined in each device's profile.  
30  (e.g., turn air conditioner on/off, set temperature, etc.)
31 
32- **Device Control Capabilities Query**  
33  Provide detailed information about controllable properties, methods information for each device.
34 
35---
36 
37## Prerequisites
381. Prepare a [Personal Access Token](https://github.com/thinq-connect/pythinqconnect/blob/main/README.md#obtaining-and-using-a-personal-access-token) for ThinQ Open API calls
392. Verify your ThinQ account's country code. You can find it in the [Country Codes](https://github.com/thinq-connect/pythinqconnect/blob/main/README.md#country-codes) section.
403. Python 3.11 or higher
414. Install [uv](https://docs.astral.sh/uv/) - A fast Python package installer and resolver for Python projects
425. MCP client (Claude Desktop, etc.)
43 
44 
45---
46 
47 
48## Quick Start
49 
50### Claude Desktop
51Open up the configuration file, and add ThinQ Connect MCP config.
52* macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
53* Windows: %APPDATA%\Claude\claude_desktop_config.json
54```json
55{
56  "mcpServers": {
57    "thinqconnect-mcp": {
58      "command": "uvx",
59      "args": [
60        "thinqconnect-mcp"
61      ],
62      "env": {
63          "THINQ_PAT": "your_personal_access_token_here",
64          "THINQ_COUNTRY": "your_country_code_here"
65      }
66    }
67  }
68}
69```
70 
71---
72 
73## Detailed Usage
74 
75After setting up the configuration file as shown in the Quick Start section, you can use the ThinQ Connect MCP Server directly in your conversations with Claude.
76 
77Examples of prompts you can use:
78 
79 * "Please provide a list of all devices"
80 * "Please check the status of the robot vacuum device"
81 * "Please set the temperature of the air conditioner device to 24 degrees"
82 
83 
84---
85 
86## Tool Reference
87 
88### Available Tools
89 
901. **get_device_list**
91   - Description: Retrieves a list of all devices connected to the ThinQ Connect platform
92   - Parameters: None
93   - Returns: String containing connected device list information
94 
952. **get_device_available_controls**
96   - Description: Retrieves available control commands and parameter information for a specific device
97   - Parameters: device_type (string), device_id (string)
98   - Returns: String containing device control commands and parameter information
99 
1003. **get_device_status**
101   - Description: Retrieves status information for a specific device
102   - Parameters: device_id (string)
103   - Returns: String containing device status information
104 
1054. **post_device_control**
106   - Description: Send control commands to a specific device on the ThinQ Connect platform to change its settings or state
107   - Parameters: device_type (string), device_id (string), control_method (string), control_params (dict)
108   - Returns: String containing device control result message
109