Official Browserless.io server for headless browser automation and web scraping through the Browserless API.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add browserless --env BROWSERLESS_TOKEN='<BROWSERLESS_TOKEN>' -- npx -y @browserless.io/mcp~/.codex/config.toml
[mcp_servers.browserless]
command = "npx"
args = ["-y", "@browserless.io/mcp"]
env = { BROWSERLESS_TOKEN = "<BROWSERLESS_TOKEN>" }
# codex mcp add browserless --env BROWSERLESS_TOKEN='<BROWSERLESS_TOKEN>' -- npx -y @browserless.io/mcp~/.cursor/mcp.json
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"@browserless.io/mcp"
],
"env": {
"BROWSERLESS_TOKEN": "<BROWSERLESS_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"browserless": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@browserless.io/mcp"
],
"env": {
"BROWSERLESS_TOKEN": "<BROWSERLESS_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"@browserless.io/mcp"
],
"env": {
"BROWSERLESS_TOKEN": "<BROWSERLESS_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"@browserless.io/mcp"
],
"env": {
"BROWSERLESS_TOKEN": "<BROWSERLESS_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"@browserless.io/mcp"
],
"env": {
"BROWSERLESS_TOKEN": "<BROWSERLESS_TOKEN>"
}
}
}
}Remote
claude mcp add --transport http browserless https://mcp.browserless.io/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.browserless]
url = "https://mcp.browserless.io/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add browserless --url https://mcp.browserless.io/mcp~/.cursor/mcp.json
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"browserless": {
"type": "http",
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"browserless": {
"httpUrl": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.browserless.io/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
BROWSERLESS_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.