MCP Directory

How to add MCP Browser Agent to Claude Desktop

Autonomous browser automation for Claude Desktop via Playwright, plus an HTTP API client. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 39★ · stdio · no auth

Claude Desktop config for MCP Browser Agent

git clone https://github.com/imprvhub/mcp-browser-agent && cd mcp-browser-agent && npm install && npm run build
{
  "mcpServers": {
    "mcp-browser-agent": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-browser-agent/dist/index.js",
        "--browser",
        "chrome"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the MCP Browser Agent config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm MCP Browser Agent's tools appear under the 🔌 tools menu.

Before you start

  • Node.js 16 or higher
  • Claude Desktop
  • Playwright dependencies (installed with npm install; browser drivers downloaded automatically on first use)

What MCP Browser Agent can do in Claude Desktop

browser_navigate

Navigate to a URL. Params: url (required), timeout, waitUntil.

browser_screenshot

Capture a screenshot. Params: name (required), selector, fullPage, mask, savePath.

browser_click

Click an element. Params: selector (required).

browser_fill

Fill a form input. Params: selector (required), value (required).

browser_select

Select a dropdown option. Params: selector (required), value (required).

browser_hover

Hover over an element. Params: selector (required).

browser_evaluate

Execute JavaScript in the browser context. Params: script (required).

api_get

Perform an HTTP GET request. Params: url (required), headers.

Security

Provides Claude with autonomous browser control; review the repo's SECURITY.md for prohibited uses and best practices. Built on Playwright, which has known issues; Chrome/Chromium processes may not terminate cleanly and sometimes need manual cleanup.

MCP Browser Agent + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the MCP Browser Agent config there under the "mcpServers" key and restart the client.

Is MCP Browser Agent safe to use with Claude Desktop?

Provides Claude with autonomous browser control; review the repo's SECURITY.md for prohibited uses and best practices. Built on Playwright, which has known issues; Chrome/Chromium processes may not terminate cleanly and sometimes need manual cleanup.

Which browsers are supported?

Chrome (default), Firefox (Nightly), Microsoft Edge, and WebKit (the engine behind Safari). Select one via the .mcp_browser_agent_config.json file, the --browser CLI argument, the MCP_BROWSER_TYPE environment variable, or the args in claude_desktop_config.json.

Is it published to npm?

No. You install it by cloning the repository, running npm install, and npm run build, then point Claude Desktop at dist/index.js.

Why do I see a 'Server disconnected' error in Claude Desktop?

Usually the absolute path in claude_desktop_config.json is wrong or the server isn't running. Verify the path (use double backslashes on Windows) and try running node dist/index.js manually from the project directory.

View repo Full MCP Browser Agent page