
Browser Use
from mhazarabad
Automate browser tasks using the Browser Use API.
Simple Browser Use MCP server
Overview
A Model Context Protocol server for automating browser tasks using Browser Use API. This server provides tools to run browser automation tasks, monitor task status, and manage running tasks.
Tools
-
run task- Run a Browser Use automation task with instructions and wait for completion
- Input:
instructions(string): Instructions for the browser automation taskstructured_output(string, optional): JSON schema for structured outputparameters(object, optional): Additional parameters for the task
- Returns: Information about the created task including final output if wait_for_completion is True
-
get task- Get details of a Browser Use task by ID
- Input:
task_id(string): ID of the task to retrieve
- Returns: Complete task information including steps and output
-
get task status- Get the status of a Browser Use task
- Input:
task_id(string): ID of the task to check
- Returns: Current status of the task
-
stop task- Stop a running Browser Use task
- Input:
task_id(string): ID of the task to stop
- Returns: Confirmation of task being stopped
-
pause task- Pause a running Browser Use task
- Input:
task_id(string): ID of the task to pause
- Returns: Confirmation of task being paused
-
resume task- Resume a paused Browser Use task
- Input:
task_id(string): ID of the task to resume
- Returns: Confirmation of task being resumed
-
list tasks- List all Browser Use tasks
- Returns: List of all tasks with their IDs and statuses
-
check balance- Check your Browser Use account balance
- Returns: Account balance information
Prompts
browser-use-task- Run a Browser Use automation task
- Input:
instructions(string): Instructions for the browser automation taskstructured_output(string, optional): JSON schema for structured output
- Returns: Formatted task details as conversation context
Claude Desktop
Add this to your claude_desktop_config.json:
"mcpServers": {
"browser-use": {
"command": "uv",
"args": [
"run",
"/path/to/simple-browser-use-mcp/src/server.py",
"--api-key",
"YOUR_BROWSER_USE_API_KEY"
]
}
}pip install simple-browser-use-mcpPrerequisites
- A Browser Use API key
to get a Browser Use API key, go to Cloud Browser Use and sign up.
Installation
Installing via pip
pip install simple-browser-use-mcpRunning the Server
Using Python directly
python /path/to/simple-browser-use-mcp/src/server.py --api-key YOUR_BROWSER_USE_API_KEYUsing uvx (recommended)
First, install uv if you haven't already:
curl -LsSf https://astral.sh/uv/install.sh | shThen you can run the server using uvx:
uvx run /path/to/simple-browser-use-mcp/src/server.py --api-key YOUR_BROWSER_USE_API_KEYOr, for development purposes, you can use:
uv run /path/to/simple-browser-use-mcp/src/server.py --api-key YOUR_BROWSER_USE_API_KEYNo common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.