How to add browser-use-mcp-server to Cursor
Let AI agents control a real web browser to browse, navigate, and extract data via browser-use + Playwright. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 822★ · sse · apikey
Cursor config for browser-use-mcp-server
uv tool install browser-use-mcp-server{
"mcpServers": {
"browser-use-mcp-server": {
"url": "http://localhost:8000/sse"
}
}
}Remote server — no local install needed. Restart the client after saving the config.
Setup steps
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the browser-use-mcp-server config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of browser-use-mcp-server's tools to confirm it's connected.
Before you start
- uv (Python package manager)
- Playwright with a Chromium install (uv run playwright install --with-deps --no-shell chromium)
- mcp-proxy (required for stdio mode)
- An OpenAI API key (OPENAI_API_KEY)
What browser-use-mcp-server can do in Cursor
browser task (natural language)Accepts a natural-language instruction and drives a real Chromium browser to carry it out — for example, 'open https://news.ycombinator.com and return the top ranked article'. Browser operations execute asynchronously; set PATIENT=true if the API call should wait for the task to complete before returning. (The README documents the capability and example usage but does not enumerate individual tool names.)
Security
Requires an OPENAI_API_KEY supplied via a .env file or the client's env block. The Docker image exposes a VNC server (port 5900) with a default password of `browser-use`; override it by mounting a custom password file as a secret. The server drives a real browser that can visit arbitrary URLs, so treat tasks and target sites as untrusted.
browser-use-mcp-server + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the browser-use-mcp-server config there under the "mcpServers" key and restart the client.
Is browser-use-mcp-server safe to use with Cursor?
Requires an OPENAI_API_KEY supplied via a .env file or the client's env block. The Docker image exposes a VNC server (port 5900) with a default password of `browser-use`; override it by mounting a custom password file as a secret. The server drives a real browser that can visit arbitrary URLs, so treat tasks and target sites as untrusted.
Which transports are supported?
Both SSE and stdio. SSE runs the server directly (`uv run server --port 8000`) and clients connect to `http://localhost:8000/sse`. stdio mode requires mcp-proxy and runs `browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000`.
What API key do I need?
An OPENAI_API_KEY, provided either in a .env file or via the client config's env block. Optionally set CHROME_PATH and PATIENT (true to wait for task completion).
Can I watch the browser while it works?
Yes. The server supports VNC streaming. The Docker image exposes VNC on port 5900 (default password `browser-use`), which you can view with a VNC client or noVNC.