Mcp Server Tuya

Name: Mcp Server Tuya
Author: juanmartinsantos

@juanmartinsantos

About Mcp Server Tuya

Control your Tuya / Smart Life smart home devices through the Model Context Protocol. Turn lights on/off, adjust brightness, set colors, monitor temperature sensors, and more — from Claude, ChatGPT, Cursor, or any MCP-compatible client.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

List all devices with IDs, names, categories, and online status

Get current device state (power, brightness, temperature, etc.)

Get detailed device info (model, firmware, capabilities)

Turn on a device (supports multi-switch devices)

Turn off a device (supports multi-switch devices)

Toggle device on/off

Set light brightness (0-1000)

Set color temperature: warm (0) to cool (1000)

Set RGB color using HSV values

Send any custom command to a device

Overview

What is Mcp Server Tuya?

Mcp Server Tuya is a Model Context Protocol (MCP) server that enables AI assistants like Claude, ChatGPT, Copilot, and Cursor to control Tuya and Smart Life smart home devices via the Tuya Cloud API. It is designed for users of MCP-compatible clients who want voice or text‑based smart home control.

How to use Mcp Server Tuya?

Obtain Tuya Cloud credentials (Access ID, Access Key) from the Tuya IoT Platform, then configure your MCP client with the command uvx mcp-server-tuya and set the environment variables TUYA_ACCESS_ID, TUYA_ACCESS_KEY, and TUYA_API_ENDPOINT (region‑specific). After restarting the client, you can ask your AI assistant to list, turn on/off, or adjust devices.

Key features of Mcp Server Tuya

10 tools for complete device control (on/off, brightness, color, etc.)
Device name resolution – use friendly names instead of IDs
Intelligent caching with configurable TTL (default 60 seconds)
Supports all Tuya regions (EU, US, CN, IN)
Zero config files – credentials via environment variables
Works with Claude, ChatGPT, Copilot, Cursor, and more

Use cases of Mcp Server Tuya

List all connected Tuya devices with their status and categories
Turn smart lights on/off by name (e.g., “Living Room Light”)
Adjust brightness, color temperature, and RGB color of lights
Query device status (e.g., temperature in the kitchen, power state)
Send custom commands to any Tuya device for advanced control

FAQ from Mcp Server Tuya

How do I get Tuya credentials?

Go to the Tuya IoT Platform, create a Cloud Project with the “Smart Home” industry, link your Smart Life / Tuya Smart app, and copy the Access ID and Access Secret from the project overview.

What environment variables are required?

TUYA_ACCESS_ID and TUYA_ACCESS_KEY are required. Optionally set TUYA_API_ENDPOINT (defaults to Europe) and TUYA_CACHE_TTL (default 60 seconds).

What API endpoints are available for different regions?

Europe: https://openapi.tuyaeu.com, Americas: https://openapi.tuyaus.com, China: https://openapi.tuyacn.com, India: https://openapi.tuyain.com.

Why am I getting a “Device not found” error?

The device name used in the command does not match the exact name in your Tuya account. Use the tuya_list_devices tool to see

Comments

More AI & Agents MCP servers

meGPT - upload an author's content into an LLM

adrianco

Code to process many kinds of content by an author into an MCP server

287

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416