Browser-Use MCP

v1.0.0Browser Automationstable

A FastMCP server that enables browser automation through natural language commands, allowing Language Models to browse the web, fill out forms, click buttons, and perform other web-based tasks via a simple API.

browserbrowser-usecursormcpmcp-server
Share:
822
Stars
0
Downloads
0
Weekly
0/5

What is Browser-Use MCP?

Browser-Use MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to fastmcp server that enables browser automation through natural language commands, allowing language models to browse the web, fill out forms, click buttons, and perform other web-based tasks via a sim...

A FastMCP server that enables browser automation through natural language commands, allowing Language Models to browse the web, fill out forms, click buttons, and perform other web-based tasks via a simple API.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A FastMCP server that enables browser automation through nat

Use Cases

Natural language browser automation
Form filling, clicking, and web task execution
LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx browser-use-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Browser-Use MCP

browser-use-mcp-server is a FastMCP server that enables AI language models to control a real Chromium browser through natural language commands via the browser-use and Playwright libraries. It exposes browser automation as MCP tools — letting AI agents navigate websites, fill out forms, click buttons, extract text, and perform complex multi-step web tasks — all accessible from Claude, Cursor, Windsurf, and other MCP clients without writing any automation code.

Prerequisites

  • Python 3.11 or later installed
  • uv Python package manager (recommended) or pip
  • OPENAI_API_KEY for the underlying browser-use AI agent
  • mcp-proxy installed (for stdio transport mode)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install uv and clone the repository

Install the uv package manager, then clone the browser-use-mcp-server repository.

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/kontext-security/browser-use-mcp-server.git
cd browser-use-mcp-server
2

Install dependencies and Playwright

Sync dependencies with uv and install Playwright with Chromium for browser automation.

uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium
3

Install mcp-proxy for stdio mode

Install mcp-proxy to enable stdio transport, which is required for Claude Desktop and similar MCP clients.

uv tool install mcp-proxy
4

Configure environment variables

Create a .env file with your OpenAI API key and any optional settings.

OPENAI_API_KEY=sk-...
# Optional:
CHROME_PATH=/path/to/custom/chrome
PATIENT=true
5

Start the server in SSE mode

Run the FastMCP server. By default it starts in SSE mode on port 8000.

uv run server --port 8000
6

Connect your MCP client

Add the browser-use-mcp-server to your MCP client configuration. The config path varies by client (see examples below).

Browser-Use MCP Examples

Client configuration

Claude Desktop configuration for browser-use-mcp-server using SSE transport on localhost port 8000.

{
  "mcpServers": {
    "browser-use": {
      "url": "http://localhost:8000/sse",
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Prompts to try

Example prompts for browser automation tasks via the browser-use MCP server.

- "Open https://news.ycombinator.com and return the titles of the top 5 ranked articles"
- "Go to https://example.com/login, fill in username '[email protected]' and password from my notes, then click Login"
- "Navigate to the Wikipedia article on quantum computing and extract the key concepts from the introduction"
- "Search for 'Python MCP server' on GitHub and list the top 3 repository names and star counts"

Troubleshooting Browser-Use MCP

Playwright browser fails to launch

Run 'uv run playwright install --with-deps --no-shell chromium' to ensure Chromium and all system dependencies are installed. On Linux, you may need additional system packages installed by the --with-deps flag.

MCP client shows connection refused on port 8000

Ensure the server is running with 'uv run server --port 8000' before connecting the client. Check that no firewall or other process is blocking port 8000.

Browser automation tasks time out or fail mid-task

Set PATIENT=true in your .env file to make the server await task completion before returning. Complex multi-step tasks on slow websites may need this setting to avoid premature timeouts.

Frequently Asked Questions about Browser-Use MCP

What is Browser-Use MCP?

Browser-Use MCP is a Model Context Protocol (MCP) server that fastmcp server that enables browser automation through natural language commands, allowing language models to browse the web, fill out forms, click buttons, and perform other web-based tasks via a simple api. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Browser-Use MCP?

Follow the installation instructions on the Browser-Use MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Browser-Use MCP?

Browser-Use MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Browser-Use MCP free to use?

Yes, Browser-Use MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "browser-use-mcp-server": { "command": "npx", "args": ["-y", "browser-use-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Browser-Use MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides