iRobot Roomba + Home Assistant

1. Supported Models

The iRobot integration supports most WiFi-connected Roomba models, but the level of functionality varies significantly by generation:

2. Integration Setup

Step 1: Set Up in iRobot App

Your Roomba must be fully set up and working through the iRobot Home app first:

• Download the iRobot Home app
• Create an iRobot account
• Add your Roomba and connect it to WiFi
• Run at least one cleaning cycle to verify everything works
• For room-specific cleaning, complete a mapping run so the robot learns your floor plan

Step 2: Add Integration

1. Go to Settings → Devices & Services
2. Click + Add Integration
3. Search for iRobot Roomba and Braava
4. Enter your iRobot account email and password

Step 3: Verify Connection

After authentication, your Roomba should appear as a device with several entities. Check that the vacuum entity shows the correct state (docked, cleaning, idle, etc.).

3. Available Entities

The iRobot integration creates the following entities for each Roomba:

Vacuum Entity

• Start/stop/pause: Basic cleaning control
• Return to dock: Send the robot home
• Locate: Make the robot play a sound to find it
• Fan speed: Set cleaning power (Eco, Normal, Performance, where supported)

Sensors

• Battery level: Current charge percentage
• Bin full: Binary sensor indicating the dustbin needs emptying (models without auto-empty base)
• Cleaning state: Current activity (cleaning, paused, docked, returning, error)
• Last cleaning area: Square footage of last cleaning run (some models)
• Last cleaning duration: How long the last run took

What You Won't Get

• Visual map display in HA dashboards
• Obstacle detection alerts (j-series feature, app-only)
• Clean Map reports (requires iRobot subscription)
• Detailed per-room cleaning statistics

4. Limitations

Be aware of these limitations before relying on the Roomba integration for critical automations:

Cloud Dependency

Every command from Home Assistant goes through iRobot's cloud servers. This means:

• No vacuum control if your internet is down
• Commands may have 1-3 second latency compared to local integrations
• iRobot server outages (which have happened) disable all HA control
• iRobot could change their API at any time, potentially breaking the integration

Limited Room Control

While the iRobot app offers room-specific cleaning for i-series and newer, exposing this through Home Assistant is limited. The j7+ and newer models have the best support for room-based commands via the vacuum.send_command service, but the experience is not as polished as Roborock's implementation.

iRobot Subscription Push

iRobot has been increasingly pushing their subscription services (iRobot Select, iRobot+). While the basic Home Assistant integration doesn't require a subscription, some advanced app features that could enhance your automations (like Clean Map details) are subscription-locked.

5. Automation Ideas

Clean When Everyone Leaves

automation:
  - alias: "Vacuum when house is empty"
    trigger:
      - platform: state
        entity_id: group.family
        to: "not_home"
        for: "00:10:00"
    condition:
      - condition: time
        after: "08:00:00"
        before: "20:00:00"
      - condition: state
        entity_id: vacuum.roomba
        state: "docked"
    action:
      - service: vacuum.start
        target:
          entity_id: vacuum.roomba

Stop When Someone Arrives Home

automation:
  - alias: "Dock Roomba when someone arrives"
    trigger:
      - platform: state
        entity_id: group.family
        to: "home"
    condition:
      - condition: state
        entity_id: vacuum.roomba
        state: "cleaning"
    action:
      - service: vacuum.return_to_base
        target:
          entity_id: vacuum.roomba

Notify When Bin is Full

automation:
  - alias: "Roomba bin full alert"
    trigger:
      - platform: state
        entity_id: binary_sensor.roomba_bin_full
        to: "on"
    action:
      - service: notify.mobile_app
        data:
          title: "Roomba"
          message: "The dustbin is full. Please empty it before the next cleaning cycle."

Schedule by Day of Week

automation:
  - alias: "Roomba MWF schedule"
    trigger:
      - platform: time
        at: "10:00:00"
    condition:
      - condition: time
        weekday:
          - mon
          - wed
          - fri
      - condition: state
        entity_id: group.family
        state: "not_home"
    action:
      - service: vacuum.start
        target:
          entity_id: vacuum.roomba

6. Better Alternatives

If you're shopping for a new robot vacuum specifically for Home Assistant, these options offer a better experience:

Valetudo: The Local-First Option

For full local control without any cloud dependency, Valetudo is an open-source firmware replacement for supported robot vacuums (primarily Dreame, Roborock, and some Viomi models). It provides a complete local web interface, MQTT integration with Home Assistant, visual maps on your dashboard, and room-specific cleaning with zero cloud dependency. The trade-off is that it requires rooting your vacuum, which voids the warranty.

7. Troubleshooting

Authentication Failed

• Verify your iRobot credentials work in the iRobot Home app
• Check if iRobot requires a password reset or has flagged your account
• Ensure you're using the email format your account was created with

Vacuum Entity Shows "Unavailable"

• Check if the Roomba is connected to WiFi (try controlling it from the iRobot app)
• Restart the iRobot integration from Settings → Integrations
• Check Home Assistant logs for API error messages
• iRobot servers may be experiencing an outage. Check status.irobot.com

Commands Delayed or Not Executing

• Cloud-based commands have inherent latency (1-5 seconds is normal)
• Check your internet connection stability
• The Roomba may be in an error state (check the iRobot app for specifics)

Room Cleaning Not Working

• Verify your model supports room-specific cleaning (j7+ or newer)
• Ensure the robot has completed mapping runs in the iRobot app
• Room names must match exactly as configured in the iRobot app

8. Sources

This guide was compiled from official documentation:

• Home Assistant iRobot Roomba Integration (official docs)

Last verified: 2026-03-20 against Home Assistant 2026.1. If you find outdated information, let us know.