trackmcp
Back to directory
yasu89

switch-bot-mcp-server

View on GitHub

SwitchBot MCP Server

7 stars GoOthers Updated Apr 30, 2026
gogolangmcpmcp-serverswitchbot

Documentation

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

json
{
  "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.

json
{
  "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_devices`Get SwitchBot devices
`get_switch_bot_device_status`Get SwitchBot device status
`execute_command`Execute a command on a device

Frequently asked questions

What is switch-bot-mcp-server?

switch-bot-mcp-server is SwitchBot MCP Server

How do I install switch-bot-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is switch-bot-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/yasu89/switch-bot-mcp-server and has 7 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP