Saros Dashboard#

CLI, MCP server, web dashboard, and Home Assistant control layer for the Roborock Saros 10R robot vacuum, built on python-roborock. Control cleaning, monitor status, manage room schedules, and open autonomous cleaning windows from the terminal, browser, Home Assistant, or an AI assistant.

GitHub

Features#

• CLI (vacuum) — status, start/stop/pause/dock, room selection, routines, consumables, history
• Web dashboard — responsive PWA with status, scheduling, room controls, clean history, consumable gauges, and trigger management
• MCP server — exposes vacuum tools to AI assistants via the Model Context Protocol
• Home Assistant API — stable /api/ha summary and action endpoints for dashboard cards, scripts, and automations
• Autonomous cleaning windows — timed windows dispatch the most-overdue rooms that fit the remaining budget
• Triggers — named presets open or extend cleaning windows with a configured budget and vacuum/mop mode
• Scheduling — SQLite-backed per-room vacuum and mop intervals with overdue detection, priority scoring, notes, and duration estimates
• Mode-specific dispatch settings — separate fan speed, mop mode, water flow, and route defaults for vacuum and mop workflows
• Consumables — percentage-remaining gauges for main brush, side brush, filter, and sensor

Cloud API only — the Saros 10R uses a newer local protocol not yet supported by python-roborock. All commands relay through Roborock’s cloud MQTT broker.

Stack#

TypeScript, React, TailwindCSS, Python, FastAPI, Typer, SQLite, python-roborock, MCP, Home Assistant REST integration.