SwitchBot MCP Server

SwitchBot MCP Server is an MCP server that enables users to interactively manage and operate SwitchBot smart home hardware using the official SwitchBot API. Designed for developers, home automation enthusiasts, and users running AI assistants such as Claude Desktop, it exposes structured tools to control various connected appliances. By connecting an LLM to the SwitchBot cloud interface, users can query device lists, retrieve real-time operational statuses, and execute standard device commands through conversational prompts. This integration eliminates the need to manually access the SwitchBot mobile application for everyday routines, allowing assistants to perform coordinated operations across multiple devices simultaneously. Users can also implement dynamic automation logic, such as inspecting the reading from one sensor or device and using that data to immediately trigger an action on a secondary appliance, bridging local home setups with agentic capabilities.

Category: Cloud & Infrastructure

Tags: automation, iot, smart-home, switchbot

Visit SwitchBot MCP Server

How to install and configure SwitchBot MCP Server

1. Obtain your SwitchBot API token and secret by following the official SwitchBot API documentation. 2. Choose between running the server via Docker or downloading a pre-compiled binary from the repository release page. 3. Add the server configuration to your Claude Desktop configuration file under mcpServers. For Docker: 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" } } } } For binary: json { "mcpServers": { "switchbot": { "command": "~/Downloads/switch-bot-mcp-server", "env": { "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN", "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET" } } } } 4. Restart Claude Desktop to load the SwitchBot tools.

What you can do with SwitchBot MCP Server

• Listing all registered SwitchBot devices linked to your account to inspect device types and identifiers directly from an AI chat interface. - Checking current device operational metrics and status reports such as battery, mode, or temperature before triggering changes. - Dispatching action commands simultaneously across multiple SwitchBot appliances to handle complex multi-room automation routines. - Reading telemetry data from a designated SwitchBot sensor and using the returned value to determine conditional actions on another device.

Key facts

• https://github.com/yasu89/switch-bot-mcp-server
• Cloud & Infrastructure, Other & General Purpose
• automation, iot, smart-home, switchbot

Part of MCP Servers

What is SwitchBot MCP Server?

SwitchBot MCP Server is a Model Context Protocol server that interfaces with the official SwitchBot API. It allows compatible LLM interfaces like Claude Desktop to discover smart devices, fetch live telemetry status, and send operational control commands.

What tools are included in SwitchBot MCP Server?

The server includes three primary tools: get_switch_bot_devices to fetch available hardware, get_switch_bot_device_status to inspect current device states, and execute_command to trigger actions directly on connected devices.

Which MCP clients work with SwitchBot MCP Server?

It is designed to work with any client supporting the Model Context Protocol stdio transport layer, including Claude Desktop, by executing either the Docker container image or the standalone binary.

What credentials are required to use SwitchBot MCP Server?

You need a valid SwitchBot API token and secret. These environment variables, SWITCH_BOT_TOKEN and SWITCH_BOT_SECRET, must be supplied in your client configuration file so the server can authenticate against the SwitchBot cloud API.