Paired with a browser extension, lets agents manage tabs, search history and read page content in the user's browser.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add browser-control --env EXTENSION_SECRET='<EXTENSION_SECRET>' --env EXTENSION_PORT='<EXTENSION_PORT>' -- node /path/to/repo/mcp-server/dist/server.js~/.codex/config.toml
[mcp_servers.browser-control]
command = "node"
args = ["/path/to/repo/mcp-server/dist/server.js"]
env = { EXTENSION_SECRET = "<EXTENSION_SECRET>", EXTENSION_PORT = "<EXTENSION_PORT>" }
# codex mcp add browser-control --env EXTENSION_SECRET='<EXTENSION_SECRET>' --env EXTENSION_PORT='<EXTENSION_PORT>' -- node /path/to/repo/mcp-server/dist/server.js~/.cursor/mcp.json
{
"mcpServers": {
"browser-control": {
"command": "node",
"args": [
"/path/to/repo/mcp-server/dist/server.js"
],
"env": {
"EXTENSION_SECRET": "<EXTENSION_SECRET>",
"EXTENSION_PORT": "<EXTENSION_PORT>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"browser-control": {
"type": "stdio",
"command": "node",
"args": [
"/path/to/repo/mcp-server/dist/server.js"
],
"env": {
"EXTENSION_SECRET": "<EXTENSION_SECRET>",
"EXTENSION_PORT": "<EXTENSION_PORT>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"browser-control": {
"command": "node",
"args": [
"/path/to/repo/mcp-server/dist/server.js"
],
"env": {
"EXTENSION_SECRET": "<EXTENSION_SECRET>",
"EXTENSION_PORT": "<EXTENSION_PORT>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"browser-control": {
"command": "node",
"args": [
"/path/to/repo/mcp-server/dist/server.js"
],
"env": {
"EXTENSION_SECRET": "<EXTENSION_SECRET>",
"EXTENSION_PORT": "<EXTENSION_PORT>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"browser-control": {
"command": "node",
"args": [
"/path/to/repo/mcp-server/dist/server.js"
],
"env": {
"EXTENSION_SECRET": "<EXTENSION_SECRET>",
"EXTENSION_PORT": "<EXTENSION_PORT>"
}
}
}
}Environment variables
EXTENSION_SECRETEXTENSION_PORT
Replace the placeholders with your own credentials and keep them out of version control.