Switch Bot Mcp Server
About
Control SwitchBot devices interactively using the SwitchBot API.
Details
- License
- MIT
Explore
- Retrieve a list of paired SwitchBot devices.
- Get the current status of a specific device.
- Execute commands (e.g., turn on/off) on devices.
- Operate devices interactively through MCP.
- Perform actions across multiple devices in one session.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Switch Bot Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain the token and secret from SwitchBotAPI via the official Getting Started guide. Configure the server in Claude Desktop using either Docker (recommended) or a pre‑compiled binary, setting the two environment variables SWITCH_BOT_TOKEN and SWITCH_BOT_SECRET.
get_switch_bot_devices
Get SwitchBot devices
get_switch_bot_device_status
Get SwitchBot device status
execute_command
Execute a command on a device
Retrieving devices, retrieving statuses, and executing commands on devices are available.
| Tool Name | Description |
|--------------------------------|-------------------------------|
| get_switch_bot_devices | Get SwitchBot devices |
| get_switch_bot_device_status | Get SwitchBot device status |
| execute_command | Execute a command on a device |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"switch bot mcp server": {
"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>"
}
}
}
}
}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>"
}
}
}
The SwitchBot MCP Server is a Model Context Protocol (MCP) server that provides a feature to control SwitchBot devices interactively using SwitchBotAPI.
Use Cases
- Operate SwitchBot devices interactively
- Perform operations on multiple devices at once
- Use data retrieved from a device to operate another device
Installation
Prepare secret and token
Follow the Getting Started guide of SwitchBotAPI to obtain the token and secret for SwitchBotAPI.
Setting for Claude Desktop
Using Docker (recommended)
{
"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"
}
}
}
}
Using binary
<details>
<summary>Details</summary>
Download binary from release page.
{
"mcpServers": {
"switchbot": {
"command": "~/Downloads/switch-bot-mcp-server",
"env": {
"SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
"SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
}
}
}
}
</details>
Available Tools
Retrieving devices, retrieving statuses, and executing commands on devices are available.
| Tool Name | Description |
|--------------------------------|-------------------------------|
| get_switch_bot_devices | Get SwitchBot devices |
| get_switch_bot_device_status | Get SwitchBot device status |
| execute_command | Execute a command on a device |
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
