- name
- ecovacs-mcp
- description
- Control Ecovacs robot vacuums (DEEBOT series) via the official Ecovacs MCP server — start/stop/pause cleaning, send the robot to its dock, check battery and cleaning status, list devices. Use this skill whenever the user mentions their robot vacuum, DEEBOT, Ecovacs, floor cleaning robot, or wants to vacuum, mop, clean the house, check if the vacuum is charging, or send it home — even if they don't say "Ecovacs" explicitly.
- user-invocable
- false
- metadata
- {"clawdbot":{"emoji":"🤖","requires":{"anyBins":["uvx","python3"],"env":["ECO_API_KEY"]},"primaryEnv":"ECO_API_KEY"}}
Ecovacs Robot Vacuum Control
Control Ecovacs robot vacuums through the official Ecovacs MCP server. This is the first official MCP integration for robotic cleaning devices.
Prerequisites
- API Key (
ECO_API_KEY) from open.ecovacs.com uvx(recommended) orpython3withecovacs-robot-mcpinstalled- A robot registered in the Ecovacs mobile app, bound to the same account
MCP Server Configuration
The MCP server entry should look like this in your settings:
{
"ecovacs_mcp": {
"command": "uvx",
"args": ["--from", "ecovacs-robot-mcp", "python", "-m", "ecovacs_robot_mcp"],
"env": {
"ECO_API_KEY": "YOUR_API_KEY",
"ECO_API_URL": "https://open.ecovacs.com"
}
}
}Regional endpoints:
- International:
https://open.ecovacs.com - China mainland:
https://open.ecovacs.cn
MCP Tools Reference
The server exposes four tools. All device operations use a nickname parameter that supports fuzzy matching — you don't need the exact name.
get_device_list
Lists all robots bound to the account. No parameters. Always call this first to discover available robots and their nicknames.
start_cleaning
Controls cleaning operations.
| Parameter | Values | Description |
|---|---|---|
nickname | string | Robot name (fuzzy match) |
act | s | Start cleaning |
act | p | Pause cleaning |
act | r | Resume cleaning |
act | h | Stop cleaning |
control_recharging
Controls dock/charging operations.
| Parameter | Values | Description |
|---|---|---|
nickname | string | Robot name (fuzzy match) |
act | go-start | Return to charging dock |
act | stopGo | Cancel return to dock |
query_working_status
Returns real-time robot state. No input besides nickname. Returns three status fields:
cleanSt— Cleaning state (sweeping, mopping, paused, idle, mapping)chargeSt— Charging state (returning to dock, docking, charging, idle)stationSt— Dock station state (washing mop, drying, dust collection, idle)
Operating Guidance
- Always list devices first — call
get_device_listbefore any operation to get the correct nickname. Cache the nickname for the session. - Confirm actions — after starting or stopping cleaning, call
query_working_statusto verify the command took effect. - Standard workflows:
- *Start cleaning:* list devices → start_cleaning (act: s) → check status - *Send home:* control_recharging (act: go-start) → check status - *Pause and resume:* start_cleaning (act: p) → later (act: r)
- Natural language mapping:
- "vacuum the house" / "clean the floor" / "start cleaning" → start_cleaning act: s - "send it back" / "dock" / "go home" / "charge" → control_recharging act: go-start - "stop" / "pause" → start_cleaning act: p or h - "what's it doing?" / "is it charging?" → query_working_status
Troubleshooting
- No devices found — robot must be set up in the Ecovacs app and bound to the same account used for the API key
- Authentication errors — verify
ECO_API_KEYis correct andECO_API_URLmatches your region - Server won't start — ensure
uvxis available (pip install uv), or install directly:pip install ecovacs-robot-mcp