Eufy RoboVac MCP Server

A Model Context Protocol (MCP) server for controlling Eufy RoboVac devices. Built with TypeScript and Vite.

Setup

1. Install dependencies:

2. Get your device credentials:

   • Device ID and Local Key from your Eufy Home app or network analysis

   • Find your RoboVac's IP address on your network

Related MCP server: mcp-server-unitycatalog

Development

Run in development mode with hot reload:

Type checking:

Production

Build the project:

Run the built server:

Available Tools

Connection & Setup

• robovac_scan_network - Scan local network for RoboVac devices (🆕 no credentials needed!)

• robovac_connect_discovered - Connect to a discovered device using its IP

• robovac_connect - Manual connection using device credentials

• robovac_auto_initialize - Cloud-based discovery (⚠️ May not work due to API changes)

Basic Controls

• robovac_start_cleaning - Start cleaning cycle

• robovac_stop_cleaning - Stop cleaning cycle

• robovac_return_home - Return to charging dock

• robovac_play - Start/resume cleaning

• robovac_pause - Pause cleaning

• robovac_find_robot - Make the RoboVac beep to locate it

Advanced Controls

• robovac_set_work_mode - Set cleaning mode (AUTO, SMALL_ROOM, SPOT, EDGE, NO_SWEEP)

• robovac_set_clean_speed - Set suction power (STANDARD, BOOST_IQ, MAX, NO_SUCTION)

Status Information

• robovac_get_status - Get current device status (legacy)

• robovac_get_battery - Get battery level

• robovac_get_error_code - Get current error code

• robovac_get_work_mode - Get current cleaning mode

• robovac_get_clean_speed - Get current suction level

• robovac_get_work_status - Get detailed work status

• robovac_get_play_pause - Get play/pause state

Utility Functions

• robovac_format_status - Print formatted status to console

• robovac_get_all_statuses - Get all status information at once

Usage with MCP Client

🆕 Easy Setup with Network Scan (Recommended)

1. Scan your local network to find RoboVac devices:

This will show you:

• All devices with open Tuya/Eufy ports (6668, 6667, 443)

• Devices with Anker/Eufy MAC addresses (⭐ likely RoboVacs)

• IP addresses of potential devices

2. Connect to a discovered device:

Getting Device Credentials

You still need the device ID and local key:

1. Try community tools:

   • eufy-security-client or similar projects

   • Check GitHub for updated credential grabbers

2. Network traffic analysis:

   • Monitor Eufy app network traffic

   • Use tools like Wireshark or Charles Proxy

3. Router/firmware methods:

   • Some routers log device information

   • Check if your RoboVac firmware exposes credentials

Alternative Methods

Manual connection (if you have all credentials):

Cloud discovery (may not work due to API changes):

Control Your RoboVac

Once connected, use any control tools: