Mcp Server Tuya MCP Server

A Model Context Protocol (MCP) server that lets AI assistants (Claude, ChatGPT, Copilot, Cursor, and more) control your Tuya / Smart Life smart home devices.

Local serverstdio

What is the Mcp Server Tuya MCP Server?

Mcp Server Tuya is an MCP project maintained in the juanmartinsantos/mcp-server-tuya repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that lets AI assistants (Claude, ChatGPT, Copilot, Cursor, and more) control your Tuya / Smart Life smart home devices”. Read the project documentation for the complete scope.

Installation

The documented pypi package is mcp-server-tuya. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TUYA_ACCESS_ID, TUYA_ACCESS_KEY, TUYA_API_ENDPOINT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
tuya_list_devicesList all devices with IDs, names, categories, and online status
tuya_get_device_statusGet current device state (power, brightness, temperature, etc.)
tuya_get_device_infoGet detailed device info (model, firmware, capabilities)
tuya_turn_on_deviceTurn on a device (supports multi-switch devices)
tuya_turn_off_deviceTurn off a device (supports multi-switch devices)
tuya_toggle_deviceToggle device on/off
tuya_set_brightnessSet light brightness (0-1000)
tuya_set_color_temperatureSet color temperature: warm (0) to cool (1000)
tuya_set_colorSet RGB color using HSV values
tuya_send_commandSend any custom command to a device

How to install the Mcp Server Tuya MCP Server

{
  "mcpServers": {
    "tuya": {
      "command": "uvx",
      "args": [
        "mcp-server-tuya"
      ],
      "env": {
        "TUYA_ACCESS_ID": "your_access_id",
        "TUYA_ACCESS_KEY": "YOUR_TUYA_ACCESS_KEY",
        "TUYA_API_ENDPOINT": "https://openapi.tuyaeu.com"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TUYA_ACCESS_IDDeclared in the maintainer’s client configuration.Yes
TUYA_ACCESS_KEYDeclared in the maintainer’s client configuration.Yes
TUYA_API_ENDPOINTDeclared in the maintainer’s client configuration.Optional