AI Developer Tools
sharkclean-mcp
MCP server for SharkClean / SharkNinja robot vacuums that enables agentic control via any MCP client: start cleanings, clean rooms, dock, and check status in plain language.
sharkclean-mcp
What is sharkclean-mcp?
sharkclean-mcp is an MCP server that allows AI agents to control SharkClean robot vacuums through natural language commands. It communicates with SharkNinja's cloud backend to start cleanings, clean specific rooms, dock, and monitor status.
How to use sharkclean-mcp?
- 1Clone the repository and navigate to its directory.
- 2Run 'uv sync' to install dependencies.
- 3Copy .env.example to .env and add your SharkClean app email and password.
- 4Run 'uv run shark-mcp-auth' to perform a one-time browser login.
- 5Verify setup with 'uv run shark-mcp-doctor'.
- 6Register the MCP server with your client (e.g., Claude Code or Claude Desktop) using the command provided.
sharkclean-mcp Key Features
- List robots on the account
- Get live status (cleaning/paused/docked, battery, charging, errors)
- Start whole-home cleaning with optional power mode
- List rooms from the robot's map
- Clean specific rooms
- Pause, resume, or stop cleaning
- Return robot to dock
- Set power mode (eco/normal/max)
- Locate robot with beep
sharkclean-mcp Use Cases
- Start a max-power clean via an AI assistant
- Vacuum the kitchen and living room using natural language
- Check robot status and battery level
- Send the robot back to its dock after cleaning
- Automate cleaning tasks in scripts or cron jobs
sharkclean-mcp Pricing & Free Credits
sharkclean-mcp currently operates on a Free model.
sharkclean-mcp Pros & Cons
Pros
- Works with newer robots not supported by legacy SDK
- Uses MCP protocol for AI integration
- Open source with clear documentation
- Supports multi-robot accounts
Cons
- Unofficial, not affiliated with SharkNinja
- Requires one-time browser login due to Auth0 restrictions
- Auth0 tokens may expire and need re-authentication
- Room targeting requires a completed map from the robot
What is sharkclean-mcp best for?
- Developers integrating SharkClean vacuums into AI workflows
- Home automation enthusiasts using MCP-compatible clients
- Users with newer SharkNinja robot vacuums