Switchbot

Provides SwitchBot device control capabilities to AI assistants via an MCP server.

javascript

5

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "genm-switchbot-mcp": {
      "command": "node",
      "args": [
        "path/to/switchbot-mcp/build/index.js"
      ],
      "env": {
        "SWITCHBOT_TOKEN": "your_token",
        "SWITCHBOT_SECRET": "your_secret"
      }
    }
  }
}

You can run and use a SwitchBot MCP Server to enable AI assistants to control SwitchBot devices, query their status, and manage scenes and device settings through a dedicated MCP interface.

How to use

You will connect an MCP client to the SwitchBot MCP Server using a local STDIO configuration. This server provides commands to list devices, get device status, turn devices on or off, adjust device settings, execute scenes, and monitor device-related sensors. Configure your MCP client to launch the server process and supply the required environment variables containing your SwitchBot credentials. Once connected, you can issue high-level actions to control SwitchBot devices from your assistant.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

Install via Smithery (recommended for Claude Desktop integration):

npx -y @smithery/cli install @genm/switchbot-mcp --client claude

How to install

Manual installation steps you can follow locally:

npm install @genm/switchbot-mcp

Available tools

List devices

Retrieve all registered SwitchBot devices and present them to your AI assistant.

Get device status

Query the current status of a specific SwitchBot device.

Turn on/off device

Toggle power state for a selected device.

Change device settings

Adjust configurable settings on a device (like brightness, mode, or intensity).

Execute scenes

Run predefined scenes to control multiple devices together.

Device status monitoring

Provide ongoing or periodic status updates for monitored devices.