Lotus MCP
Create browser automation skills by demonstration. Works with Cursor and Claude Code.
What is Lotus?
Lotus lets you create reusable browser automations ("skills") just by showing what you want to do. Demonstrate a workflow in a browser, narrate what you're doing, and Lotus converts it into an executable skill you can run anytime.
Prerequisites
macOS:
brew install sox
Linux:
sudo apt-get install sox libsox-fmt-all
Windows: Download and install SoX from https://sox.sourceforge.net/
Cursor Setup
1. Install
# Install the MCP
npm install -g github:chrisvin-jabamani/lotus-mcp --ignore-scripts
# Install the Cursor extension
curl -L -o /tmp/lotus.vsix https://github.com/chrisvin-jabamani/lotus-mcp/raw/main/extension/lotus-0.1.0.vsix
cursor --install-extension /tmp/lotus.vsix
2. Configure
Create a file at ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:
{
"mcpServers": {
"lotus": {
"command": "lotus-mcp-cursor",
"env": {
"LOTUS_API_KEY": "your-api-key",
"LOTUS_URL": "https://www.uselotus.ai"
}
}
}
}
Quick setup (copy-paste into terminal):
mkdir -p ~/.cursor
cat > ~/.cursor/mcp.json << 'EOF'
{
"mcpServers": {
"lotus": {
"command": "lotus-mcp-cursor",
"env": {
"LOTUS_API_KEY": "your-api-key",
"LOTUS_URL": "https://www.uselotus.ai"
}
}
}
}
EOF
Get your API key at uselotus.ai
3. Restart Cursor
Quit and reopen Cursor. Look for the green dot next to "lotus" in Cursor Settings → MCP.
4. Create your first skill
Ask Claude:
"Create a skill to check court availability on Rec.us"
The browser opens inside Cursor. Demonstrate the workflow, then say "I'm done."
Claude Code Setup
1. Install
npm install -g github:chrisvin-jabamani/lotus-mcp --ignore-scripts
2. Configure
claude mcp add lotus -- lotus-mcp-cli
Set environment variables when prompted:
LOTUS_API_KEY— Get yours at uselotus.aiLOTUS_URL—https://www.uselotus.ai
3. Create your first skill
Ask Claude:
"Create a skill to check court availability on Rec.us"
The browser opens in Chrome/Safari. Demonstrate the workflow, then say "I'm done."
How It Works
"Create a skill to book a tennis court"
↓
Browser opens automatically
↓
You demonstrate the workflow
(narrate what you're doing)
↓
"I'm done"
↓
✅ Skill created and ready to use
Tools
| Tool | Description |
|---|---|
lotus_start_recording | Start recording a workflow |
lotus_stop_recording | Stop and analyze |
lotus_refine_skill | Convert to executable skill |
lotus_refine_status | Check progress |
lotus_refine_answer | Answer AI questions |
lotus_cancel_session | Cancel current session |
Troubleshooting
Installation fails with ENOENT error?
- Make sure to use
--ignore-scriptsflag:npm install -g github:chrisvin-jabamani/lotus-mcp --ignore-scripts
"spawn sox ENOENT" or audio errors?
- Install SoX:
brew install sox(macOS) orapt-get install sox(Linux)
Browser doesn't open in Cursor?
- Check extension installed:
Cmd+Shift+P→ "Lotus: Open Browser" - Look for "Lotus" in the status bar (bottom right)
- Run command manually if needed
"Failed to connect to Lotus" or "API returned HTML"?
- Verify your API key is correct at uselotus.ai
- Check
LOTUS_URLis exactlyhttps://www.uselotus.ai - Check MCP server logs: In Cursor, go to Output panel → select "Lotus" from dropdown
MCP not loading in Cursor?
- Verify
~/.cursor/mcp.jsonexists and has valid JSON - Check for green dot in Cursor Settings → MCP
- Try restarting Cursor completely
License
MIT