Switch Bot MCP Server

@yasu89

Repository

Basic information

About Switch Bot MCP Server

SwitchBot MCP Server

#go #golang #mcp#switchbot#mcp-server

Switch Bot MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Switch Bot MCP Server tools

Get SwitchBot devices

Get SwitchBot device status

Execute a command on a device

Overview

What is Switch Bot Mcp Server?

It is a Model Context Protocol (MCP) server that enables interactive control of SwitchBot devices using the SwitchBotAPI. It is designed for users who want to operate their SwitchBot hardware through LLM-based tools such as Claude Desktop.

How to use Switch Bot Mcp Server?

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.

Key features of Switch Bot Mcp Server

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.

Use cases of Switch Bot Mcp Server

Operate SwitchBot devices interactively from a conversational AI.
Execute commands on multiple devices at the same time.
Use data retrieved from one device to trigger an action on another.

Frequently asked questions

What does the server actually do?

It provides three MCP tools – `get_switch_bot_devices`, `get_switch_bot_device_status`, and `execute_command` – that let an LLM or other MCP client discover and control SwitchBot hardware via the SwitchBot cloud API.

How do I obtain my SwitchBot API token and secret?

Follow the SwitchBotAPI Getting Started guide (linked in the README) to generate a token and secret for API access.

How can I configure the server for Claude Desktop?

Two methods are available. The recommended approach uses Docker: set the server command to `docker run` with the necessary environment variables. Alternatively, download the binary from the releases page and point the `command` field directly to it.

What runtime dependencies does it require?

The server runs either inside Docker (image `yasu89/switch‑bot‑mcp‑server:latest`) or as a standalone binary. No other runtime dependencies are listed.

Where does device data live?

Device information and status are fetched on demand from the SwitchBot cloud API. The server does not store any data locally.

Comments

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.