Expose browser-use capabilities as an MCP server for AI assistants like Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
:browser_navigate
Parameter | Type | Required | Description |
---|---|---|---|
url | string | Yes | URL to navigate to |
new_tab | boolean | No | Open in new tab (default: false) |
browser_go_back
browser_click
Parameter | Type | Required | Description |
---|---|---|---|
index | number | Yes | Element index from browser state |
new_tab | boolean | No | Open link in new tab (default: false) |
new_tab
is true:
browser_type
Parameter | Type | Required | Description |
---|---|---|---|
index | number | Yes | Element index from browser state |
text | string | Yes | Text to type |
browser_scroll
Parameter | Type | Required | Description |
---|---|---|---|
direction | "up" | "down" | No | Scroll direction (default: “down”) |
browser_get_state
Parameter | Type | Required | Description |
---|---|---|---|
include_screenshot | boolean | No | Include base64 screenshot (default: false) |
index
: Used to reference the element in other commands (click, type)tag
: HTML tag name (button, input, a, etc.)text
: Visible text content, truncated to 100 charactersplaceholder
: For input fields (if present)href
: For links (if present)browser_extract_content
Parameter | Type | Required | Description |
---|---|---|---|
query | string | Yes | What to extract (e.g., “all product prices”) |
extract_links | boolean | No | Include links in extraction (default: false) |
OPENAI_API_KEY
environment variable for AI extraction.
browser_list_tabs
browser_switch_tab
Parameter | Type | Required | Description |
---|---|---|---|
tab_id | string | Yes | ID of tab to switch to (last 4 characters of TargetID) |
browser_close_tab
Parameter | Type | Required | Description |
---|---|---|---|
tab_id | string | Yes | ID of the Tab to close (last 4 characters of TargetID) |
~/Downloads/browser-use-mcp/
~/.browser-use-mcp
for extraction operations~/Downloads/browser-use-mcp/
browser_
that directly interact with the browserbrowser_use_run_task
)"Error: {message}"
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/Library/Logs/Claude/mcp.log
%APPDATA%\Claude\logs\mcp.log
browser_extract_content
returns errors:
OPENAI_API_KEY
is set in the environment configurationLimitation | Description | Workaround |
---|---|---|
Single Browser Session | One browser instance per server | Restart server for new session |
No Domain Restrictions Config | Cannot configure allowed domains via env vars | Modify server code if needed |
No Agent Mode | browser_use_run_task is commented out | Use direct browser control tools |
Text-Only Responses | All responses are text strings | Parse JSON responses client-side |
Feature | MCP Server (this) | MCP Client |
---|---|---|
Purpose | Expose browser to AI | Connect agent to tools |
User | Claude Desktop, etc. | Browser-use agents |
Direction | External → Browser | Agent → External |
Configuration | JSON config file | Python code |
Tools | Fixed browser tools | Dynamic from server |
Use Case | Interactive assistance | Automated workflows |