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

Open Cursor Settings (Cmd+Shift+J) → MCP → Add:

{
  "mcpServers": {
    "lotus": {
      "command": "lotus-mcp-cursor",
      "env": {
        "LOTUS_API_KEY": "your-api-key",
        "LOTUS_URL": "https://www.uselotus.ai"
      }
    }
  }
}

Get your API key at uselotus.ai

3. Restart Cursor

Quit and reopen Cursor.

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.ai
• LOTUS_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

Troubleshooting

Installation fails with ENOENT error?

• Make sure to use --ignore-scripts flag: npm install -g github:chrisvin-jabamani/lotus-mcp --ignore-scripts

"spawn sox ENOENT" or audio errors?

• Install SoX: brew install sox (macOS) or apt-get install sox (Linux)

Browser doesn't open in Cursor?

• Check extension installed: Cmd+Shift+P → "Lotus: Open Browser"
• Run command manually if needed

"Failed to connect to Lotus"?

• Verify your API key is correct
• Check LOTUS_URL is https://www.uselotus.ai

License

MIT