Install Mearl

Run setup, choose a browser connection, then verify your first task. The Chrome extension is optional for connecting your everyday browser.

1. Set up Mearl 2. Choose a browser connection

1. Set up Mearl

Installation guide

Requires Node.js 20.18.0 or later. Each browser or Provider has its own requirements.

Run the installer. If you plan to use an agent, select its Skill integration when prompted.

Shell

npx @mearl/setup

2. Choose a browser connection

Connections & sessions

Setup prepares your local tools. Choose one of the following connections for the browser you want to use.

Everyday browser · extension: Reuse open tabs and your existing sign-in. Follow the optional extension steps below.
Browser / Electron · CDP: Connect a browser or Electron client page with remote debugging enabled, without the Mearl extension.
External environment · Provider: Connect a local or remote browser or device through its Provider. Available actions depend on the Provider.
Cloud access · Cloud Connector: Relay requests through Cloud Server to the host that runs the browser. That host uses its configured browser connection.

Optional: connect your everyday browser

Explore the Toolbox

Install the extension in the Chrome profile whose tabs and sign-in you want to reuse. It also provides the Toolbox and DevTools panel. Requires Chrome 120 or later.

Chrome Web Store Download offline ZIP 3.0.12

Use the version that matches your local runtime. Extract the ZIP and open chrome://extensions/, enable Developer mode, and select the extracted folder with Load unpacked.

3. Verify the connection

Continue to quick start

Keep the selected environment running. If using the extension, enable Agent Service under Settings → Services in Mearl. Check the environment and list the connected browsers.

Shell

mearl check
mearl browser_list

Confirm that your intended browser appears in the list. With multiple connections, give your agent its browserId.

Connect through MCP

MCP

Once the local connection works, run the MCP installer, select your client, and restart the client so it loads the tools.

Shell

npx @mearl/setup --mcp