yasu89/switch-bot-mcp-server repository overview

⁠SwitchBot MCP Server

日本語はこちら⁠

The SwitchBot MCP Server is a Model Context Protocol (MCP)⁠ server that provides a feature to control SwitchBot devices interactively using SwitchBotAPI⁠.

⁠Use Cases

• Operate SwitchBot devices interactively
• Perform operations on multiple devices at once
• Use data retrieved from a device to operate another device

⁠Installation

⁠Prepare secret and token

Follow the Getting Started guide of SwitchBotAPI⁠ to obtain the token and secret for SwitchBotAPI.

⁠Setting for Claude Desktop

⁠Using Docker (recommended)

{
  "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"
      }
    }
  }
}

⁠Using binary

{
  "mcpServers": {
    "switchbot": {
      "command": "~/Downloads/switch-bot-mcp-server",
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

⁠Available Tools

Retrieving devices, retrieving statuses, and executing commands on devices are available.