switch-bot-mcp-server

switch-bot-mcp-server

3.3

If you are the rightful owner of switch-bot-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The SwitchBot MCP Server is a Model Context Protocol server designed to control SwitchBot devices interactively using the SwitchBotAPI.

SwitchBot MCP Server

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

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"
      }
    }
  }
}

Available Tools

Retrieving devices, retrieving statuses, and executing commands on devices are available.

Tool NameDescription
get_switch_bot_devicesGet SwitchBot devices
get_switch_bot_device_statusGet SwitchBot device status
execute_commandExecute a command on a device