mcpField
S
Switch Bot Mcp Server

Switch Bot Mcp Server

Local
github.com/yasu89Other7Updated 71w ago
Repository

About Switch Bot Mcp Server

Switch Bot Mcp Server is an MCP server for controlling SwitchBot devices through SwitchBotAPI. It supports device discovery, status checks, and commands, including operations across multiple devices.

Key features

  1. 01Find SwitchBot devices
  2. 02Retrieve device status
  3. 03Execute device commands
  4. 04Operate multiple devices

Use cases

  1. 01Check the status of a SwitchBot device
  2. 02Control several devices at once
  3. 03Use one device’s data to operate another

MCP support

Exposes SwitchBot device discovery, status retrieval, and command execution as tools for MCP clients.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "switch-bot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SWITCH_BOT_TOKEN",
        "-e",
        "SWITCH_BOT_SECRET",
        "yasu89/switch-bot-mcp-server:latest"
      ],
      "env": {
        "SWITCH_BOT_TOKEN": "<SWITCH_BOT_TOKEN>",
        "SWITCH_BOT_SECRET": "<SWITCH_BOT_SECRET>"
      }
    }
  }
}
Run commanddocker run -i --rm -e SWITCH_BOT_TOKEN -e SWITCH_BOT_SECRET yasu89/switch-bot-mcp-server:latest
Environment variables to set
SWITCH_BOT_TOKENSecret
SWITCH_BOT_SECRETSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ociyasu89/switch-bot-mcp-server:latest

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

SwitchBot MCP Server

Go Report Card Coverage Code to Test Ratio Test Execution Time

日本語はこちら

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.