Switchbot

🚀 @genm/switchbot-mcp

A Model Context Protocol (MCP) server that provides control capabilities for SwitchBot devices, enabling AI assistants to control SwitchBot devices.

Japanese Version

🚀 Quick Start

This is a Model Context Protocol (MCP) server that offers control capabilities for SwitchBot devices, allowing AI assistants to control these devices.

✨ Features

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

📦 Installation

Install via Smithery

Automatically install the SwitchBot MCP server for running with Claude Desktop through Smithery:

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

Manual Installation

npm install @genm/switchbot-mcp

📚 Documentation

1. SwitchBot API Configuration

1. Install the SwitchBot application.
2. Create an account and log in.
3. Go to Profile > Settings > Developer Options.
4. Obtain your token and secret.

2. MCP Server Configuration

Add the following content 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

• Sockets
  • Living room floor lamp
  • Office computer power supply
• Robots
  • Kitchen coffee maker
  • Living room air purifier
• Curtains
  • Bedroom window treatments
  • Study blackout curtains
• Air conditioners
  • Living room air conditioner
  • Bedroom air conditioner
• Humidifiers
  • Bedroom humidifier
  • Study humidifier
• Lights
  • Kitchen main light
  • Bedroom night light
• Remote control devices
  • Living room TV
  • Study fan

💡 Device Naming Examples

To facilitate the understanding of AI assistants, it is recommended to provide descriptive names for devices. For example:

• "Bedroom curtains" instead of "Curtains"
• "Living room air conditioner" instead of "Air conditioner"

This naming convention helps AI assistants identify the location and purpose of devices.

💻 Supported Operations

Device Management

• List devices
• Get device status
• Control device on/off
• Adjust device settings

Scene Management

• List scenes
• Execute scenes

Sensor Information

• Temperature
• Humidity
• Brightness
• Motion sensing

🔧 Development

# Build
npm run build

# Development mode (TypeScript)
npm run dev

# Start
npm start

🛠️ Troubleshooting

Device Not Responding

1. Confirm that the device is within the Bluetooth range.
2. Check the device battery status.
3. Confirm the connection status of the SwitchBot repeater.

Authentication Error

1. Check the validity period of the token and secret.
2. Regenerate the token and secret.
3. Update the environment variables.

📄 License

ISC