%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%23061b40;%20}%20.st1%20{%20fill:%20%23306af1;%20}%20.st2%20{%20fill:%20%235ce5cf;%20}%20%3c/style%3e%3c/defs%3e%3cg%3e%3cpath%20class='st0'%20d='M55,10.5h9v3h-9v9h12V7.5h-12v3ZM64,19.5h-6v-3h6v3Z'/%3e%3cpolygon%20class='st0'%20points='69%2016.5%2078%2016.5%2078%2019.5%2069%2019.5%2069%2022.5%2081%2022.5%2081%2013.5%2072%2013.5%2072%2010.5%2081%2010.5%2081%207.5%2069%207.5%2069%2016.5'/%3e%3cpolygon%20class='st0'%20points='95%2010.5%2095%207.5%2083%207.5%2083%2022.5%2095%2022.5%2095%2019.5%2086%2019.5%2086%2016.5%2095%2016.5%2095%2013.5%2086%2013.5%2086%2010.5%2095%2010.5'/%3e%3cpath%20class='st0'%20d='M40,1.5v21h11.6l1.4-1.4v-7.6h0c0,0-1.4-1.5-1.4-1.5l1.4-1.4V2.9l-1.4-1.4h-11.6ZM50,19.5h-7v-6h7v6ZM50,10.5h-7v-6h7v6Z'/%3e%3c/g%3e%3cpath%20class='st1'%20d='M23.1,24L14.7,4.8l-4.9,11.2h3.8l-1.8,4H3.3L12.1,0H2C.9,0,0,.9,0,2v20c0,1.1.9,2,2,2h21.1Z'/%3e%3cpath%20class='st2'%20d='M34,0h-16.8l10.6,24h6.2c1.1,0,2-.9,2-2V2C36,.9,35.1,0,34,0ZM32.5,20h-4V4h4v16Z'/%3e%3c/svg%3e)
Tuya MCP Server
tuyactl is a command-line tool for controlling Tuya devices. It interacts with Tuya devices through local keys and needs to be used in conjunction with an independent Tuya server.
rating : 2 points
downloads : 15
What is tuyactl?
tuyactl is a command-line interface that allows you to directly control your Tuya smart devices (such as lights, plugs, etc.) from your computer without the need for the official Tuya app. It operates by communicating with your devices via local network connections.How does it work?
The tool connects to your Tuya devices using special access keys (referred to as 'local keys') that you obtain through a setup process. It then sends commands directly to the devices on your local network.When would I use this?
Use tuyactl when you want to automate your smart devices, integrate them with other systems, or control them without using your phone. It is ideal for home automation scripts and tech enthusiasts who prefer command-line tools.Key Features
Device ControlTurn devices on/off, adjust brightness, change colors (for compatible devices), and set modes
Local Network ControlCommunicates directly with devices on your local network without relying on cloud services
ScriptableCan be used in scripts and automated workflows since it is command-line based
Pros and Cons
Advantages
Faster response time than cloud-based controls
Works even if the internet connection is down
More privacy since data stays on your local network
Enables automation through scripts
Limitations
Requires technical setup to obtain device keys
Only works with Tuya devices that support local control
Need to manually update device keys if they change
No official support from Tuya
Getting Started
Install the uv package manager
This is required to run the tuyactl tool. It is a fast Python package installer.
%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%230080ff;%20}%20%3c/style%3e%3c/defs%3e%3cpath%20class='st0'%20d='M16.2,11.1c.4.5.4,1.2,0,1.8l-4.7,7.1h-3.8l5.3-8L7.6,4h3.8l4.7,7.1Z'/%3e%3c/svg%3e)
Get your device keys
Use the tinytuya setup wizard to obtain local keys for your devices. This creates a snapshot.json file.
Start the server
Run the background server that tuyactl communicates with.
Start using tuyactl
You can now control your devices. Try listing them first to see what is available.
Example Scenarios
Turning on living room lights at sunsetUse in a scheduled script to automatically turn on lights when it gets dark
Creating a reading light presetSet your lamp to the perfect brightness and color temperature for reading
Frequently Asked Questions
Where should I place the snapshot.json file?
Why can't my computer find my Tuya devices?
Is this tool officially supported by Tuya?
Helpful Resources
uv Documentation
Installation and usage guide for the uv package manager
tinytuya GitHub
The tool used to obtain local keys for your devices
Tuya Local Control Protocol
Technical details about how local control works
Featured MCP Services
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
141
4.5 points
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
86
4.3 points
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
1.7K
5 points
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
830
4.3 points
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
566
5 points
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
6.7K
4.5 points
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
754
4.8 points
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
284
4.5 points