Lightweight Chrome-free browser for agents that runs JavaScript, follows links, fills forms, manages cookies and returns compact page maps.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add unbrowser -- uvx pyunbrowser~/.codex/config.toml
[mcp_servers.unbrowser]
command = "uvx"
args = ["pyunbrowser"]
# codex mcp add unbrowser -- uvx pyunbrowser~/.cursor/mcp.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}.vscode/mcp.json
{
"servers": {
"unbrowser": {
"type": "stdio",
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}Remote
claude mcp add --transport http unbrowser https://unbrowser--protostatis-dev.run.tools~/.codex/config.toml
[mcp_servers.unbrowser]
url = "https://unbrowser--protostatis-dev.run.tools"
# codex mcp add unbrowser --url https://unbrowser--protostatis-dev.run.tools~/.cursor/mcp.json
{
"mcpServers": {
"unbrowser": {
"url": "https://unbrowser--protostatis-dev.run.tools"
}
}
}.vscode/mcp.json
{
"servers": {
"unbrowser": {
"type": "http",
"url": "https://unbrowser--protostatis-dev.run.tools"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"unbrowser": {
"httpUrl": "https://unbrowser--protostatis-dev.run.tools"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"unbrowser": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://unbrowser--protostatis-dev.run.tools"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"unbrowser": {
"url": "https://unbrowser--protostatis-dev.run.tools"
}
}
}