SwitchBot

Control SwitchBot devices interactively using the SwitchBot API.

Install

Install and configure the MCP from https://github.com/yasu89/switch-bot-mcp-server now. Follow the repository's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View source on GitHub

README

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