Browser Use MCP server for AI agents

MCP-browser-use is a server that connects MCP clients (like Claude or Cursor) with browser functionality through the browser-use library. It allows your AI assistant to interact with web content without requiring you to pay for an additional LLM API key - it simply leverages the LLM already configured in your MCP client.

Installation

To use mcp-browser-use, you need to install it first. The easiest way is through pip:

pip install mcp-browser-use

For the latest version, you can install it directly from GitHub:

pip install git+https://github.com/vinayak-mehta/mcp-browser-use.git

You'll also need to have uvx installed, which is part of the Universal Vertex (uv) ecosystem:

pip install uvx

Usage

Basic Configuration

To connect mcp-browser-use with an MCP client, add the following command to your client's configuration:

uvx mcp-browser-use

Using Full Paths

To prevent the MCP client from failing to start the server, it's recommended to use the full path to the uvx executable:

/path/to/uvx mcp-browser-use

You can find the full path to uvx using:

which uvx

Client-Specific Setup

Claude

For Anthropic's Claude:

Go to settings in the Claude interface
Navigate to the MCP section
Enter the command:
```
/full/path/to/uvx mcp-browser-use
```
Save the configuration

Cursor

For Cursor IDE:

Open settings in Cursor
Find the AI/MCP configuration section
Add the following command:
```
/full/path/to/uvx mcp-browser-use
```
Apply the changes

Once configured, your AI assistant will be able to browse the web and interact with web content when requested.

Troubleshooting

Common Issues

If you encounter errors when starting the MCP server:

Ensure uvx is properly installed
Try using the full path to the uvx executable
Check that mcp-browser-use is installed correctly
Verify your internet connection

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "browser-use" '{"command":"uvx","args":["mcp-browser-use"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "browser-use": {
            "command": "uvx",
            "args": [
                "mcp-browser-use"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "browser-use": {
            "command": "uvx",
            "args": [
                "mcp-browser-use"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect