get_roomsLABSCO SUMMARY
The state of the house becomes something you can ask about mid-sentence.
Rooms, devices and their current state come back as structured data, and the same connection sends the command — so "is the garage light still on" and "turn it off" are one exchange instead of an app and a second thought.
What it is
A small layer over the SmartThings API covering four things: your rooms, your devices, the current state of a device, and the commands that change it. It runs locally over stdio, or as the container the repository ships.
What you get
- Every room in the home, as UUIDs mapped to the names you gave them
- The device list, with filtering, so a large home does not arrive as one wall of devices
- The current status of any device, looked up by its UUID
- Commands sent to a device, so a reading and the action that follows it happen on one connection
Requirements
A SmartThings personal token, passed to the server as TOKEN. Then either uv, to run it from source, or Docker — the included Dockerfile takes the same token as an environment variable.
Setup effort
Follow the published steps — docker build -t smartthings-mcp .
USE CASES
01
Checking whether anything was left on before you leave
Walk the rooms, take the devices in each, and read their current state — a sweep of the whole house without opening a single app screen.
02
Switching something off from wherever you are
Find the device by name in the list, then send it the command. The lookup and the action are the same conversation, so nothing has to be identified twice.
03
Taking stock of one room
Resolve the room to its UUID, pull only the devices that belong to it, and read each one's state — useful when the answer you want is about the kitchen, not the house.
04
Finding the device you actually meant
Device names drift over time and duplicates accumulate. List with a filter, check the status of the candidates, and act on the one that is really the lamp you had in mind.
4 tools
Listed in project docs. Your client may show a different list.
get_devicesget_device_statusexecute_commandsBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
TOKEN in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/veonua/smartthings-mcp
cd smartthings-mcpDocker
TERMINAL
docker build -t smartthings-mcp .
docker run -e TOKEN=<YOUR_TOKEN> smartthings-mcp
