@genm/switchbot-mcp

A Model Context Protocol server that provides SwitchBot device control capabilities to AI assistants.

Features

List devices
Get device status
Control devices (on/off)
Change device settings
Scene control
Device status monitoring

Installation

Installing via Smithery

To install SwitchBot MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install @genm/switchbot-mcp

Setup

1. SwitchBot API Configuration

Install the SwitchBot app
Create an account and sign in
Go to Profile > Settings > Developer Options
Get both the token and secret key

2. MCP Server Configuration

Add the following to claude_desktop_config.json:

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

3. Environment Variables

SWITCHBOT_TOKEN=your_token
SWITCHBOT_SECRET=your_secret

Supported Devices

Plug
- Living Room Floor Lamp
- Office PC Power Supply
Bot
- Kitchen Coffee Maker
- Living Room Air Purifier
Curtain
- Bedroom Window Curtain
- Study Room Blackout Curtain
Air Conditioner
- Living Room AC
- Bedroom AC
Humidifier
- Bedroom Humidifier
- Study Room Humidifier
Light
- Kitchen Ceiling Light
- Bedroom Night Light
Remote Control
- Living Room TV
- Study Room Fan

Device Name Examples

It's recommended to give descriptive names to your devices for easier control by AI assistants. Examples:

"Bedroom Curtain" instead of just "Curtain"
"Living Room AC" instead of just "Air Conditioner"
"Kitchen Coffee Maker" instead of just "Bot"

This naming convention helps AI assistants understand the context and location of each device.

Supported Operations

Device Management

List devices
Get device status
Turn devices on/off
Change device settings

Scene Management

List scenes
Execute scenes

Sensor Information

Temperature
Humidity
Brightness
Motion

Development

# Build
npm run build

# Development mode (TypeScript)
npm run dev

# Start
npm start

Troubleshooting

Device Not Responding

Verify the device is within Bluetooth range
Check device battery status
Verify SwitchBot hub connection status

Authentication Errors

Check token and secret key expiration
Regenerate token and secret key
Update environment variables

License

ISC