How To Guide

How to use `BrowserOS-mcp` on Claude Code

Download binary from BrowserOS.com
Open BrowserOS and from a new tab click the settings icon to open the settings page.
From the settings page, navigate to MCP in the sidebar and copy the MCP URL

In your terminal, type the below command (Replace <mcp_url> with the MCP URL you copied above):

claude mcp add --transport http browseros <mcp_url>
# example: claude mcp add --transport http browseros http://127.0.0.1:9226/mcp

Now start Claude Code: claude --dangerously-skip-permissions (so Claude doesn’t ask for confirmation each time)
Now, in Claude Code, type Open amazon.com on browseros to open the tab in BrowserOS.

Here’s a loom video capturing the above steps! 🥳

The steps are roughly the same as above, but to add the MCP server, run the following command:

gemini mcp add local-server <mcp_url> --transport http
# example: gemini mcp add local-server http://127.0.0.1:9226/mcp --transport http

Download binary from BrowserOS.com
Open BrowserOS and from a new tab click the settings icon to open the settings page. From the settings page, navigate to MCP in the sidebar and note the port number (usually 9225).
Open your Claude Desktop config file: /Users/<username>/Library/Application Support/Claude/claude_desktop_config.json
Add BrowserOS to your config (replace the port with the value shown in MCP settings page):

{
  "mcpServers": {
    "browserOS": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:<port>/mcp"]
    }
  }
}

Restart Claude Desktop. You should see the MCP connection indicator showing BrowserOS is connected