get_switch_bot_devicesLABSCO SUMMARY
Home devices you can reason about, not only toggle.
Because status reads and commands sit side by side, 'read the bedroom thermometer and turn the fan on if it is too warm' is two calls — rather than a scene you have to build in the app before you can ask for it.
What it is
A Go server over the SwitchBot API: list the devices on your account, read one's status, and send it a command.
What you get
- Every SwitchBot device on the account, listed
- The current status of a named device
- Commands executed against a device
- Several devices operated in one exchange
- One device's reading used to decide what another device does
Requirements
A SwitchBot token and secret, obtained through the SwitchBot API getting-started guide, set as SWITCH_BOT_TOKEN and SWITCH_BOT_SECRET. Runs from the yasu89/switch-bot-mcp-server Docker image or a release binary.
Setup effort
One command plus a key — docker run -i --rm --name switch-bot-mcp-server -e SWITCH_BOT_TOKEN -e SWITCH_BOT_SECRET yasu89/switch-bot-mcp-server:latest
USE CASES
01
Checking whether you left something on
List the devices, then read the status of the one you are worried about.
02
Turning something on from wherever you are
Send the command straight to the device, without opening the app.
03
Acting on a reading from another device
Read the sensor first and let its value decide the command that follows.
04
Setting several devices at once
List what is on the account, then issue the commands together instead of one at a time in the app.
3 tools
Listed in project docs. Your client may show a different list.
get_switch_bot_device_statusexecute_commandBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- docker on PATH
- SWITCH_BOT_TOKEN in your environment
- SWITCH_BOT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
docker run -i --rm --name switch-bot-mcp-server -e SWITCH_BOT_TOKEN -e SWITCH_BOT_SECRET yasu89/switch-bot-mcp-server:latestMCP Clients
Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"switchbot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--name",
"switch-bot-mcp-server",
"-e",
"SWITCH_BOT_TOKEN",
"-e",
"SWITCH_BOT_SECRET",
"yasu89/switch-bot-mcp-server:latest"
],
"env": {
"SWITCH_BOT_TOKEN": "<YOUR_SWITCH_BOT_TOKEN>",
"SWITCH_BOT_SECRET": "<YOUR_SWITCH_BOT_SECRET>"
}
}
}
}
