@genm/switchbot-mcp

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

日本語

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

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCPMC (Minecraft MCP)
gerred
-
security
A
license
-
quality
Enables AI agents to control Minecraft bots through a standardized JSON-RPC interface.
Last updated -
4
34
MIT License
Home Assistant MCP
guilhermelirio
A
security
A
license
A
quality
Provides tools for AI assistants to interact with smart home devices through Home Assistant, allowing operations like checking entity states and calling services.
Last updated -
3
3
MIT License
WordPress MCP Server
prathammanocha
A
security
A
license
A
quality
Enables AI assistants to interact with WordPress sites through REST APIs, allowing programmatic management of posts, users, comments, categories, and tags with secure authentication.
Last updated -
29
46
MIT License
Cloudflare Playwright MCP
AI24K
-
security
F
license
-
quality
Enables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.
Last updated -

View all related MCP servers

SwitchBot MCP Server