Skip to content
MCP server

Screen Mouse Recorder MCP

Local MCP server that lets AI assistants record narrated-free browser tutorial videos

Install
Pricing
Open source
Platforms
CLI, API, macOS
Runs
Remotely
Version
0.1.0
Listing updated
today

About Screen Mouse Recorder MCP

Screen Mouse Recorder MCP is an open-source MCP server for browser automation. It runs as a hosted remote server, so there is nothing to install locally.

The README describes a standalone local server that drives its own Chrome instance with Playwright and records the viewport directly, so it does not depend on the Screen Mouse Recorder browser extension. An AI client connects over Streamable HTTP on 127.0.0.1 with a bearer token, then uses tools to start a recording, navigate, click, type, scroll and stop, producing a WebM file and an MP4 when ffmpeg is installed.

The setup guide, written in Spanish, includes ready-made configuration snippets for OpenCode, Claude Code and Google Antigravity, and explains that ChatGPT's web chat cannot reach a 127.0.0.1 address. Optional environment variables control the port, headless mode, viewport size, output folder and cursor effects. A login tool is available only when explicitly enabled, and the guide warns that the password passes through the model, so a dedicated account is advised.

The server is aimed at people who want an assistant to produce walkthrough recordings of web apps they own or are authorised to record. Free use is limited to two videos through the MCP; the README lists a Pro plan with the editor and library as a separate paid product.

Install

Run in a terminal

claude mcp add screen-mouse-recorder-mcp --env SMR_MCP_TOKEN='<SMR_MCP_TOKEN>' -- npx -y screen-mouse-recorder-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "screen-mouse-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "screen-mouse-recorder-mcp"
      ],
      "env": {
        "SMR_MCP_TOKEN": "<SMR_MCP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "screen-mouse-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "screen-mouse-recorder-mcp"
      ],
      "env": {
        "SMR_MCP_TOKEN": "<SMR_MCP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "screen-mouse-recorder-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "screen-mouse-recorder-mcp"
      ],
      "env": {
        "SMR_MCP_TOKEN": "<SMR_MCP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "screen-mouse-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "screen-mouse-recorder-mcp"
      ],
      "env": {
        "SMR_MCP_TOKEN": "<SMR_MCP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "screen-mouse-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "screen-mouse-recorder-mcp"
      ],
      "env": {
        "SMR_MCP_TOKEN": "<SMR_MCP_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SMR_MCP_TOKENLocal bearer token shown in the /mcp setup guideRequired

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

browser_status
Browser connection, current page, recording state and output paths
recording_status
Live recording status, optimized for polling
start_recording
Start recording the MCP-owned viewport immediately
inspect_page
Read visible text and temporary IDs for visible controls
navigate
Navigate to an absolute http(s) URL
click_element
Click an inspected control
type_text
Type into a visible ordinary text field
login
Log in with email and password before recording when enabled
scroll
Scroll up or down
wait_for
Wait for a selector or visible text
run_flow
Run a sequence of navigate, click, type, wait, scroll and inspect steps
stop_recording
Finalize WebM and convert to MP4 when ffmpeg is available

What it does

Isolated browser recording
Runs a separate Chrome controlled by Playwright and captures only the page viewport, not the desktop.
Assistant-driven navigation
Tools let a connected client navigate, click inspected controls, type into text fields, scroll and wait for content.
WebM and MP4 output
Saves WebM recordings and converts to MP4 automatically when ffmpeg is available in PATH.
Local-only bearer auth
Listens on 127.0.0.1 only and requires a Bearer token in the Authorization header.
Optional credential login
A login tool works only when enabled by environment variable and never records the login step.

Good for

  • Recording a guided walkthrough of a web dashboard by describing steps to an AI assistant
  • Producing a short demo video of a site's sign-up or onboarding flow
  • Capturing repeatable browser sessions for internal training material
  • Generating MP4 clips of page sections with cursor highlights and automatic zoom

Pricing

Open source

Open-source local server; Pro plan with editor and library is a separate paid product at $9.99/month after a 3-day trial.

Prices change. Check screenmouserecorder.nexumaicore.com before you buy.

Screen Mouse Recorder MCP FAQ

Does it need the Chrome extension?

No. The README states it controls its own Chrome browser and does not connect to the extension, which is not required.

Which AI clients are supported?

The guide lists OpenCode, Claude Code, Claude Desktop with a remote connector or bridge, and Google Antigravity. ChatGPT web cannot connect to 127.0.0.1, while its desktop app, Codex, CLI and IDE extension can use local MCP.

Is the server open source?

The guide and README link to a public GitHub repository for the MCP server, and the server is run locally from its source.

How many free recordings are included?

The README says the free plan includes 2 videos through the MCP, after which recording requests must be refused with an upgrade message.

Is Screen Mouse Recorder MCP free?

Yes. Screen Mouse Recorder MCP is open source, so you can use and self-host it for free.

How do I add Screen Mouse Recorder MCP to Claude Code?

Run this command in your terminal: claude mcp add screen-mouse-recorder-mcp --env SMR_MCP_TOKEN='<SMR_MCP_TOKEN>' -- npx -y screen-mouse-recorder-mcp

What are the best alternatives to Screen Mouse Recorder MCP?

The closest alternatives to Screen Mouse Recorder MCP are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Screen Mouse Recorder MCP

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  4. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation
  5. Build and continue browser and Mac automation scripts for Super through Claude

    • Remote
    • Paid
    • Browser automation
  6. pour

    MCP server

    Run WCAG 2.2 accessibility audits and vision simulations on any URL from an agent

    Runs locally
    • Open source
    • Developer tools