Eufy RoboVac MCP Server provides a Model Context Protocol server for controlling Eufy RoboVac devices, allowing you to send commands and retrieve status information from your robot vacuum. This TypeScript-based implementation makes it easy to integrate with your home automation setup.
To set up the Eufy RoboVac MCP Server, follow these steps:
npm install
npm run build
npm start
Before using the server, you'll need to gather your RoboVac device credentials:
The recommended method is to scan your network to locate your device:
robovac_scan_network()
This will identify:
After finding your device, connect to it using:
robovac_connect_discovered(ip="192.168.1.100", deviceId="your_device_id", localKey="your_local_key")
Alternatively, if you already have all credentials, you can connect manually:
robovac_connect(deviceId="your_device_id", localKey="your_local_key", ip="192.168.1.100")
Once connected, you can control your RoboVac with these commands:
// Start cleaning
robovac_start_cleaning()
// Stop cleaning
robovac_stop_cleaning()
// Return to charging dock
robovac_return_home()
// Pause cleaning
robovac_pause()
// Resume cleaning
robovac_play()
// Make the RoboVac beep to locate it
robovac_find_robot()
Set cleaning modes and suction power:
// Set cleaning mode (AUTO, SMALL_ROOM, SPOT, EDGE, NO_SWEEP)
robovac_set_work_mode(mode="SPOT")
// Set suction power (STANDARD, BOOST_IQ, MAX, NO_SUCTION)
robovac_set_clean_speed(speed="MAX")
Retrieve various status information from your RoboVac:
// Get battery level
robovac_get_battery()
// Get current error code
robovac_get_error_code()
// Get current cleaning mode
robovac_get_work_mode()
// Get current suction level
robovac_get_clean_speed()
// Get detailed work status
robovac_get_work_status()
// Get play/pause state
robovac_get_play_pause()
// Get all status information at once
robovac_get_all_statuses()
// Print formatted status to console
robovac_format_status()
You'll need to obtain your device credentials through one of these methods:
Community tools:
eufy-security-client on GitHubNetwork traffic analysis:
Router inspection:
To add this MCP server to Claude Code, run this command in your terminal:
claude mcp add-json "eufy-robovac" '{"command":"npm","args":["start"],"tools":["robovac_scan_network","robovac_connect_discovered","robovac_connect","robovac_auto_initialize","robovac_start_cleaning","robovac_stop_cleaning","robovac_return_home","robovac_play","robovac_pause","robovac_find_robot","robovac_set_work_mode","robovac_set_clean_speed","robovac_get_status","robovac_get_battery","robovac_get_error_code","robovac_get_work_mode","robovac_get_clean_speed","robovac_get_work_status","robovac_get_play_pause","robovac_format_status","robovac_get_all_statuses"]}'See the official Claude Code MCP documentation for more details.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.
To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".
When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:
{
"mcpServers": {
"eufy-robovac": {
"command": "npm",
"args": [
"start"
],
"tools": [
"robovac_scan_network",
"robovac_connect_discovered",
"robovac_connect",
"robovac_auto_initialize",
"robovac_start_cleaning",
"robovac_stop_cleaning",
"robovac_return_home",
"robovac_play",
"robovac_pause",
"robovac_find_robot",
"robovac_set_work_mode",
"robovac_set_clean_speed",
"robovac_get_status",
"robovac_get_battery",
"robovac_get_error_code",
"robovac_get_work_mode",
"robovac_get_clean_speed",
"robovac_get_work_status",
"robovac_get_play_pause",
"robovac_format_status",
"robovac_get_all_statuses"
]
}
}
}To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json2. Add this to your configuration file:
{
"mcpServers": {
"eufy-robovac": {
"command": "npm",
"args": [
"start"
],
"tools": [
"robovac_scan_network",
"robovac_connect_discovered",
"robovac_connect",
"robovac_auto_initialize",
"robovac_start_cleaning",
"robovac_stop_cleaning",
"robovac_return_home",
"robovac_play",
"robovac_pause",
"robovac_find_robot",
"robovac_set_work_mode",
"robovac_set_clean_speed",
"robovac_get_status",
"robovac_get_battery",
"robovac_get_error_code",
"robovac_get_work_mode",
"robovac_get_clean_speed",
"robovac_get_work_status",
"robovac_get_play_pause",
"robovac_format_status",
"robovac_get_all_statuses"
]
}
}
}3. Restart Claude Desktop for the changes to take effect