# Screen Mouse Recorder MCP

> Screen Mouse Recorder MCP is an open-source MCP server for browser automation. Local MCP server that lets AI assistants record narrated-free browser tutorial videos. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux, self-hosted
- **Website:** https://screenmouserecorder.nexumaicore.com/mcp
- **Repository:** https://github.com/carlosdmoron/screen-mouse-recorder-mcp
- **MCP Registry name:** io.github.carlosdmoron/screen-mouse-recorder-mcp
- **Categories:** browser automation
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/screen-mouse-recorder-mcp
