SwitchBot + Home Assistant: The Complete Integration Guide

SwitchBot carved out a unique niche in the smart home world. Motorized curtain rods, physical button pushers, affordable sensors, and a smart lock that actually looks good. These Bluetooth devices pair surprisingly well with Home Assistant, whether you go direct BLE, through a Hub, or via Matter. This guide covers every SwitchBot device worth buying, the best way to connect them, and automations that put them to work.

Check Your Devices Blinds & Covers Guide

Why SwitchBot Stands Out for Home Assistant Users

Most smart home brands compete on the same turf: light bulbs, smart plugs, motion sensors. SwitchBot went sideways. They built a physical robot arm that presses buttons. A motorized rod attachment that opens your curtains. A blind tilt mechanism you stick on venetian blinds. Products nobody else makes, solving problems nobody else addresses.

For Home Assistant users, SwitchBot fills gaps that Zigbee and Wi-Fi devices simply cannot. Need to automate curtains without replacing the entire track? SwitchBot Curtain 3. Want to turn a dumb appliance smart without rewiring anything? SwitchBot Bot. Need a good-looking smart lock for European doors? SwitchBot Lock Pro.

๐ŸชŸ

Unique Motorized Covers

Curtain bots and blind tilt mechanisms that attach to existing hardware. No replacement needed, no electrician required.

๐Ÿ“ก

Bluetooth + Matter

Direct BLE connection for nearby devices, plus Matter bridge support through Hub 2 for local network control across your entire home.

๐Ÿค–

The Bot: Press Any Button

A tiny robot arm that physically pushes buttons. Automate coffee machines, old intercoms, wall switches in rentals where you cannot rewire.

๐Ÿ’ฐ

Renter Friendly

Almost everything attaches with adhesive or clips. Take it all with you when you move. Perfect for apartments and rentals.

3 Ways to Connect SwitchBot to Home Assistant

SwitchBot devices primarily use Bluetooth Low Energy (BLE). That gives you multiple paths into Home Assistant, each with different tradeoffs. Here is how they compare.

MethodLocal ControlRangeSetup EffortBest For
Direct Bluetoothโœ… Yes~10m / 30ftEasyDevices near your HA server
ESPHome BLE Proxyโœ… YesWhole homeMediumFull local coverage everywhere
SwitchBot Hub + CloudโŒ CloudWhole homeEasyQuick setup, IR control too
Hub 2 + Matterโœ… MostlyWhole homeMediumBest of both worlds

Method 1: Direct Bluetooth (Simplest)

If your Home Assistant server has Bluetooth (most Raspberry Pis and mini PCs do), it can talk to SwitchBot devices directly. Home Assistant's built-in SwitchBot integration discovers devices automatically. The catch: Bluetooth range is limited to about 10 meters through walls. Devices further away will be unreliable or invisible.

Method 2: ESPHome BLE Proxies (Best for Local Control)

This is the power-user approach. You place cheap ESP32 boards ($5 each) around your home, flash them with ESPHome as Bluetooth proxies, and they relay BLE data to Home Assistant over Wi-Fi. Your SwitchBot devices think they are talking to a nearby Bluetooth radio, but the data travels across your network to HA. Fully local, no cloud, whole-home coverage. One ESP32 per floor usually does the job.

Method 3: SwitchBot Hub (Cloud API)

The SwitchBot Hub Mini or Hub 2 connects to your SwitchBot devices via Bluetooth and talks to the SwitchBot cloud. Home Assistant then uses the SwitchBot cloud API integration to control everything. Easy to set up, but commands travel through the internet. You also get IR blaster functionality, which is great for controlling TVs and air conditioners.

Method 4: Hub 2 + Matter (Recommended)

The Hub 2 can act as a Matter bridge, exposing your SwitchBot devices to Home Assistant through the Matter protocol. This means local control over your network (commands do not leave your LAN) while still getting whole-home coverage through the Hub's Bluetooth radio. Not every SwitchBot device is supported via Matter yet, but the list keeps growing. This is probably the best option for most people in 2026.

12 Best SwitchBot Devices for Home Assistant

SwitchBot makes a lot of products. These are the ones that actually make sense in a Home Assistant setup, ordered by how useful they are.

Covers & Motors

Curtain 3

Clips onto your existing curtain rod (U-rail, I-rail, or pole) and motorizes your curtains. Quieter and faster than the Curtain 2. Solar panel accessory means you never charge it. The killer app for SwitchBot in Home Assistant.

~$70 per unit | BLE + Matter via Hub

Covers & Motors

Blind Tilt

Attaches to the tilt wand of venetian/horizontal blinds and motorizes the angle. Open, close, or set a precise tilt percentage. The only affordable way to automate venetian blinds without replacing them.

~$50 per unit | BLE + Matter via Hub

Covers & Motors

Roller Shade

Motorized roller shade that replaces your existing one. Available in multiple sizes and fabrics. More polished than the retrofit approach, but also more expensive. Good if you are starting fresh.

~$100+ per unit | BLE + Matter via Hub

Hub & Bridge

Hub 2

The Swiss Army knife hub. Built-in temperature and humidity sensor, IR blaster for TVs and ACs, Matter bridge for local HA control, and Bluetooth range extender. If you own more than two SwitchBot devices, this is a must-have.

~$50 | Wi-Fi + BLE + IR + Matter

Security

Lock Pro

Smart lock with fingerprint reader and keypad. Fits European cylinder locks (unlike most US-focused smart locks). Pairs with the Keypad Touch for multiple access methods. Works via BLE directly or Matter through Hub 2.

~$100 (lock) + $40 (keypad) | BLE + Matter via Hub

Unique

Bot

A physical robot arm that presses buttons or flips switches. Sounds gimmicky, works brilliantly. Automate coffee machines, wall-mounted intercoms, garage buttons, or any dumb device with a physical button.

~$30 | BLE + Matter via Hub

Sensors

Meter Plus

Temperature and humidity sensor with a nice e-ink display. Reports via BLE to Home Assistant. Battery lasts about a year. The display is a genuine advantage over Zigbee sensors that have no screen.

~$18 | BLE

Sensors

Contact Sensor

Door and window contact sensor with motion detection built in. Two sensors in one. Reports open/close status and detects movement in front of the door.

~$20 | BLE

Sensors

Water Leak Detector

Place it under sinks, washing machines, or water heaters. Detects water and sends an alert through Home Assistant. Cheap insurance against expensive water damage.

~$15 | BLE

Lighting

LED Strip Light

RGBW LED strip with BLE and Wi-Fi control. 16 million colors, music sync mode, and integration with HA for color automations. Not as flexible as WLED, but zero soldering required.

~$30 for 5m | BLE + Wi-Fi

Cleaning

Floor Cleaning Robot S10

Robot vacuum and mop with auto-refill water station. Integrates with Home Assistant for room cleaning, scheduling, and status monitoring. A solid competitor to Roborock and Dreame.

~$450 | Wi-Fi

Power

Plug Mini

Compact smart plug with energy monitoring. Wi-Fi and BLE dual connectivity. Works via Matter through Hub 2. Not the cheapest option (Shelly Plug S beats it on price), but the Matter support is a nice bonus.

~$16 | Wi-Fi + BLE + Matter via Hub

Setting Up SwitchBot with Home Assistant

The setup process depends on which connection method you choose. Here is the walkthrough for each approach.

Option A: Direct Bluetooth (5 minutes)

  1. Make sure your Home Assistant server has Bluetooth (built-in or USB adapter).
  2. Go to Settings โ†’ Devices & Services. HA should auto-discover nearby SwitchBot devices.
  3. Click Configure on each discovered device. Some devices may need you to press a button on them first.
  4. Your SwitchBot devices appear as entities: covers (curtain/blind), switches (bot/plug), or sensors (meter/contact).

Tip: If your HA server is more than one room away, the connection will be flaky. Use Method B or C instead.

Option B: ESPHome BLE Proxy (30 minutes)

  1. Get an ESP32 board ($5 on Amazon). The ESP32-DevKitC or ESP32-S3 both work great.
  2. Install the ESPHome add-on in Home Assistant if you have not already.
  3. Create a new ESPHome device and add the bluetooth_proxy component to the YAML config.
  4. Flash the ESP32 and place it in the room where your SwitchBot devices live.
  5. HA will discover your SwitchBot devices through the proxy automatically.
  6. For full home coverage, add one ESP32 per floor or wing of your home.

This is the recommended approach if you want fully local control and have devices spread across multiple rooms.

Option C: Hub 2 with Matter (20 minutes)

  1. Set up the Hub 2 using the SwitchBot app. Connect it to Wi-Fi and pair your devices.
  2. In the SwitchBot app, enable Matter for the Hub 2. It generates a Matter pairing code.
  3. In Home Assistant, go to Settings โ†’ Devices & Services โ†’ Add Integration โ†’ Matter.
  4. Enter the pairing code. HA connects to the Hub 2 over your local network.
  5. Your SwitchBot devices appear in HA through the Matter bridge. Commands stay on your LAN.

Note: Not all SwitchBot devices are exposed via Matter yet. Check the SwitchBot app for which devices show "Matter" support.

Option D: Cloud API (10 minutes)

  1. Set up a SwitchBot Hub (Mini or Hub 2) and pair your devices in the SwitchBot app.
  2. In the SwitchBot app, go to Profile โ†’ Preferences and get your API token and secret key.
  3. In Home Assistant, add the SwitchBot Cloud integration and enter your token and secret.
  4. All Hub-connected devices appear in HA. Commands route through SwitchBot's servers.

Easiest method, but adds latency and requires internet. Use this if you just want things working fast and do not mind the cloud dependency.

5 SwitchBot Automations That Actually Matter

Here are practical automations that play to SwitchBot's unique strengths. These are things you cannot easily do with other brands.

1. Wake-Up Curtains

Open your curtains gradually at sunrise. Way better than an alarm clock. Use the Curtain 3 position to open them slowly over 10 minutes.

automation:
  - alias: "Wake up curtains"
    trigger:
      - platform: sun
        event: sunrise
        offset: "-00:10:00"
    condition:
      - condition: state
        entity_id: binary_sensor.workday_sensor
        state: "on"
    action:
      - service: cover.set_cover_position
        target:
          entity_id: cover.switchbot_curtain_bedroom
        data:
          position: 30
      - delay: "00:05:00"
      - service: cover.set_cover_position
        target:
          entity_id: cover.switchbot_curtain_bedroom
        data:
          position: 70
      - delay: "00:05:00"
      - service: cover.open_cover
        target:
          entity_id: cover.switchbot_curtain_bedroom

2. Auto-Tilt Blinds Based on Sun Position

Use the Blind Tilt to adjust venetian blinds based on the sun's elevation. Block direct sun glare while still letting in ambient light.

automation:
  - alias: "Auto tilt blinds based on sun"
    trigger:
      - platform: state
        entity_id: sun.sun
        attribute: elevation
    condition:
      - condition: numeric_state
        entity_id: sun.sun
        attribute: elevation
        above: 10
    action:
      - service: cover.set_cover_tilt_position
        target:
          entity_id: cover.switchbot_blind_tilt_office
        data:
          tilt_position: >
            {{ [90 - (state_attr("sun.sun", "elevation") | int), 10] | max }}

3. Morning Coffee with Bot

Place a SwitchBot Bot on your coffee machine's power button. Trigger it from an automation so coffee starts brewing before you get out of bed.

automation:
  - alias: "Morning coffee"
    trigger:
      - platform: time
        at: "07:15:00"
    condition:
      - condition: state
        entity_id: binary_sensor.workday_sensor
        state: "on"
      - condition: state
        entity_id: person.your_name
        state: "home"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.switchbot_bot_coffee_machine

4. Movie Mode: Close Everything

One button press closes all curtains and blinds, dims the lights, and turns on the TV. Combine SwitchBot covers with other HA devices for the full experience.

automation:
  - alias: "Movie mode"
    trigger:
      - platform: state
        entity_id: input_boolean.movie_mode
        to: "on"
    action:
      - service: cover.close_cover
        target:
          entity_id:
            - cover.switchbot_curtain_living_room
            - cover.switchbot_blind_tilt_living_room
      - service: light.turn_on
        target:
          entity_id: light.living_room
        data:
          brightness: 25
          color_temp_kelvin: 2700
      - service: media_player.turn_on
        target:
          entity_id: media_player.apple_tv

5. Water Leak Emergency

If the water leak detector triggers, send an urgent notification with actionable buttons. Could save you thousands in water damage repair.

automation:
  - alias: "Water leak alert"
    trigger:
      - platform: state
        entity_id: binary_sensor.switchbot_water_leak_kitchen
        to: "on"
    action:
      - service: notify.mobile_app_your_phone
        data:
          title: "WATER LEAK DETECTED"
          message: "Water detected under the kitchen sink!"
          data:
            push:
              sound:
                name: default
                critical: 1
                volume: 1.0
      - service: light.turn_on
        target:
          entity_id: light.kitchen
        data:
          color_name: red
          brightness: 255

SwitchBot vs Aqara vs IKEA: Quick Comparison

Three popular brands, three very different approaches. Here is how they stack up for Home Assistant users.

FeatureSwitchBotAqaraIKEA
ProtocolBLE + Wi-Fi + MatterZigbee + MatterZigbee + Matter
Best forCovers, locks, unique gadgetsSensors, switches, FP2Affordable bulbs, blinds
Local controlBLE direct or MatterFull (Zigbee)Full (Zigbee)
Price range$$$$$
Mesh networkNoYes (Zigbee)Yes (Zigbee)
Renter friendlyโ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…โ˜…

The honest answer: most serious Home Assistant users end up mixing brands. SwitchBot for curtains and unique devices, Aqara for sensors and switches, and IKEA for affordable lighting. Pick the right tool for each job instead of going all-in on one ecosystem.

SwitchBot Pro Tips

Buy the Solar Panel for Curtain 3

The Curtain 3 runs on battery and lasts about 8 months. The solar panel accessory ($20) hangs on the window and keeps it charged indefinitely. Worth every penny to avoid climbing a ladder twice a year.

Use ESPHome Proxies Instead of Multiple Hubs

One $5 ESP32 board per floor gives you full Bluetooth coverage without buying multiple $50 hubs. Flash them with ESPHome's bluetooth_proxy component. Cheaper, local, and more reliable.

Calibrate Your Curtain Bots Properly

The Curtain 3 needs to know its full travel distance. Run the calibration in the SwitchBot app before adding it to Home Assistant. Bad calibration leads to curtains that stop halfway or run past the end.

Hub 2 as IR Blaster

The Hub 2 includes an infrared blaster. You can control TVs, air conditioners, and other IR devices through Home Assistant. Learn the IR codes in the SwitchBot app, then trigger them from HA automations.

Mix SwitchBot with Zigbee

Do not try to build your entire smart home on SwitchBot. Use it for what it does best (covers, bots, locks) and use Zigbee devices for sensors, switches, and lighting. The combination covers all your bases.

SwitchBot Starter Kits for Home Assistant

Not sure where to begin? Here are three tiers depending on your budget and what you want to automate.

STARTER

~$70

Dip your toes in

  • SwitchBot Bot ($30)
  • Meter Plus ($18)
  • Contact Sensor ($20)

Great for trying SwitchBot's unique devices. Direct BLE to HA, no hub needed.

RECOMMENDED

~$200

Cover automation focus

  • Curtain 3 ($70)
  • Blind Tilt ($50)
  • Hub 2 ($50)
  • Meter Plus ($18)

Automate one window of curtains and one of blinds. Hub 2 gives you Matter + IR control.

ALL IN

~$450

Full SwitchBot smart home

  • 2x Curtain 3 ($140)
  • Blind Tilt ($50)
  • Hub 2 ($50)
  • Lock Pro + Keypad ($140)
  • Bot ($30)
  • Water Leak Detector ($15)
  • Solar Panel ($20)

Covers, security, automation, and peace of mind. Add an ESP32 BLE proxy for best results.

Frequently Asked Questions

Does SwitchBot work with Home Assistant without the cloud?

Partially. Direct Bluetooth and ESPHome BLE proxies give you fully local control. The Hub 2 with Matter is mostly local (initial setup needs internet). The cloud API integration obviously requires internet. For the best local experience, use direct BLE for nearby devices or ESPHome proxies for whole-home coverage.

Which SwitchBot devices work best with Home Assistant?

Curtain 3, Blind Tilt, Hub 2, Lock Pro, Bot, and Meter Plus are the standout devices. The cover products (curtain and blind) are where SwitchBot truly has no competition in the HA ecosystem.

Does SwitchBot support Matter?

Yes. The Hub 2 and Hub Mini Matter Edition act as Matter bridges. They expose curtain bots, locks, plugs, and other devices to Home Assistant through Matter. Local control, no cloud dependency for commands.

How do I extend SwitchBot Bluetooth range?

Two options: ESPHome Bluetooth proxies (cheap ESP32 boards that relay BLE over Wi-Fi) or SwitchBot Hubs (which bridge BLE to your network). ESPHome proxies are cheaper and fully local. One per floor usually covers everything.

Is SwitchBot better than Aqara?

Different strengths. SwitchBot wins for motorized covers and unique gadgets (Bot, Lock Pro). Aqara wins for sensors, switches, and Zigbee mesh reliability. Most people use both.

Can I use SwitchBot Curtain 3 with any curtain rod?

The Curtain 3 supports U-rail, I-rail (flat track), and pole (round rod) curtain systems. There are different mounting accessories for each type. Check which track type you have before buying. The SwitchBot website has a compatibility guide to help you pick the right version.

Already Have SwitchBot Devices?

Run our free compatibility scan to see exactly how your SwitchBot devices connect to Home Assistant, plus get recommendations for your setup.

Free Compatibility Scan