Switch Bot Mcp Server

Created By

yasu898 months ago

The SwitchBot MCP Server is a Model Context Protocol (MCP) server that provides a feature to control SwitchBot devices interactively using SwitchBotAPI.

# go

# golang

Overview Content Tools Comments

Content

SwitchBot MCP Server

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

Server Config

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Amap Maps高德地图官方 MCP Server

Playwright McpPlaywright MCP server

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

DeepChatYour AI Partner on Desktop

Context7Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors

CursorThe AI Code Editor