Screen Mouse Recorder MCP
Local MCP server that lets AI assistants record narrated-free browser tutorial videos
- 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-mcpAdd 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.
Alternatives to Screen Mouse Recorder MCP

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation

Auto-building agents
MCP serverBuild and continue browser and Mac automation scripts for Super through Claude
- Remote
- Paid
- Browser automation

pour
MCP serverRun WCAG 2.2 accessibility audits and vision simulations on any URL from an agent
Runs locally- Open source
- Developer tools