Vibe MCP — Real Chrome, Remotely

Vibe MCP - Browser Automation for AI Agents

MCP server for Vibe AI Browser — drive your real, logged-in Chrome from any MCP client, including agents running on a different machine with no inbound port open.

⚠️ Security — treat your relay URL/UUID like a password. A relay URL or extension UUID (wss://relay.api.vibebrowser.app/ ) grants live control of your browser session (read your tabs, take screenshots, read page content). Never share it, paste it into a chat with untrusted parties, or commit it to a repo. Every example UUID in this documentation is a non-routable placeholder (YOUR-EXTENSION-UUID or 00000000-0000-0000-0000-000000000000) — substitute your own secret value locally and keep it out of version control.

Privacy

Privacy policy: https://vibebrowser.app/privacy — what the extension, the local MCP server, and the hosted relay collect, log, and retain, including the relay's security audit records and how to revoke a connection URL.

Install prompt for AI agents (OpenClaw / Hermes)

Paste the block below into your OpenClaw or Hermes agent. Replace the last line with your remote value — the connector URL (https://relay.api.vibebrowser.app/mcp/ ) shown in the Vibe extension's Settings → AI Agent Control → Remote (internet) → Relay access (a bare UUID or a wss:// relay URL also still work). That's the only edit you make.

You are setting yourself up to control my real Chrome through Vibe Browser. Work through the steps in order, and after each step confirm it worked before moving on. Do not claim a step is done until you have proven it.

1. Install the "vibebrowser" skill for your runtime:

• OpenClaw: npx -y skills add VibeTechnologies/vibe-mcp -s vibebrowser -a openclaw -g -y --copy --dangerously-accept-openclaw-risks then run openclaw skills list and confirm a "vibebrowser" row shows "ready" as installer registration.
• Hermes: npx -y skills add VibeTechnologies/vibe-mcp -s vibebrowser -y optional installer registration check: npx -y skills list shows a "vibebrowser" row.

1. Remember my remote so I only give it to you once. Save it to a file vibebrowser-cli.md in your persistent agent workspace root (the directory that holds your memory/ folder — not the shell's working dir, not $HOME unless they are the same) as a line remote: ; if your runtime can also write memory keys, additionally store it under vibebrowser_remote. On every later command — including the first message of a new conversation — load it back from that file and reuse it without asking me again.

1. Record a standing rule so you route correctly later: whenever I ask you to do anything in MY browser / MY Chrome / MY tabs / the page I'm on, use this vibebrowser skill (npx -y @vibebrowser/cli@latest with my saved remote) to drive my REAL browser — never your built-in, headless, or in-pod browser, never web-fetch instead, and never run vibebrowser. Save this rule wherever your standing instructions/memory live so it applies in future conversations.

1. Confirm you can control my Chrome, retrying on "Extension reconnecting" (wait 3s, up to 5x): npx -y @vibebrowser/cli@latest --remote " " --json status --wait-for-extension --wait-timeout 20000 npx -y @vibebrowser/cli@latest --remote " " --json snapshot --format aria

Then report: (1) is extensionConnected true, (2) did the snapshot return my real page content?

My remote:

Why Vibe MCP?

The browser-automation MCP space moved fast. Most of what used to differentiate us is now table stakes — so here is an honest scorecard. Where a competitor matches us, the column says Yes.

Two rows are ours alone:

• Outbound, cross-machine control. The Vibe extension opens an outbound WebSocket to a relay (wss://relay.api.vibebrowser.app/ ). Nothing listens on the user's machine, nothing is port-forwarded, and the agent can live in a pod, a cron job, or a chat bot. No competitor documents an extension-initiated outbound connection to a remote MCP server.
• Real profile without the dialog tax. Chrome DevTools MCP needs approval for *each* WebSocket connection to Chrome (#1794, open; persistence was closed won't-fix). The maintainer's workaround — --remote-debugging-port with a dedicated --user-data-dir — avoids the dialog by giving up your logged-in profile. So: skip the dialog, or use your real profile — not both.

Also worth knowing:

• Vendor lock-in. Claude for Chrome is GA, clicks and types via the debugger permission, and supports scheduled tasks — it is the closest competitor. But it only drives Anthropic's own surfaces (side panel, Claude Desktop connector, Cowork, Claude Code). There is no public API or MCP surface, so Codex, OpenCode, Hermes and OpenClaw cannot use it. Vibe MCP is agent-agnostic.
• Stability. Chrome DevTools MCP is explicitly experimental and currently carries open memory-leak (#2431, #2291, #2456) and concurrency (#1763, #1921) issues.

Multi-Agent Architecture

Run Claude Desktop, Cursor, VS Code Copilot, and OpenCode at once — they share control of one browser through the relay, which multiplexes requests and routes each response back to the agent that asked.

Claude Desktop       Cursor          VS Code         OpenCode

| | | | v v v v [vibebrowser-mcp] [vibebrowser-mcp] [vibebrowser-mcp] [vibebrowser-mcp] | | | | +------------------+----------------+---------------+ | v [Relay Daemon] <-- Auto-spawned, handles multiplexing | v [Vibe Extension] | v [Your Chrome]

Features

• Multi-Agent Ready - Run Claude, Cursor, VS Code, and more simultaneously against one browser
• Uses Your Browser - No separate browser instance, uses your existing Chrome with all your logins
• Remote-capable - The extension dials out to a relay, so the agent can run on another machine with no inbound port
• Local by default - In local mode everything stays on 127.0.0.1; only remote relay mode routes traffic through relay.api.vibebrowser.app
• Direct Chrome DevTools mode - Extension tools stay primary by default; use --devtools to drive your real running Chrome directly over the DevTools Protocol (no extension required)

Quick Start

1. Install the Vibe Extension

Install the Vibe AI Browser extension in Chrome, Brave, or any Chromium browser:

Option A: Chrome Web Store (Recommended)

1. Visit the Chrome Web Store
2. Click "Add to Chrome"
3. The Vibe icon will appear in your toolbar

Option B: Developer Version

1. Download the latest release ZIP
2. Extract to a permanent folder
3. Go to chrome://extensions, enable Developer Mode
4. Click "Load unpacked" and select the extracted folder

For detailed instructions, see the installation guide.

2. Configure Your AI Application

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{

"mcpServers": { "vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } } }

Restart Claude Desktop after saving.

Cursor

1. Open Cursor Settings (Cmd/Ctrl + ,)
2. Go to "Features" -> "MCP Servers"
3. Click "Add Server" and add:

{

"vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } }

Or edit ~/.cursor/mcp.json directly.

VS Code (GitHub Copilot)

Add to your VS Code settings.json:

{

"github.copilot.chat.mcpServers": { "vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } } }

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } } }

OpenCode

Add to your .opencode/config.json:

{

"mcp": { "servers": { "vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } } } }

Gemini CLI

Add to ~/.gemini/settings.json:

{

"mcpServers": { "vibe": { "command": "npx", "args": ["-y", "@vibebrowser/mcp"] } } }

OpenAI Codex CLI / ChatGPT desktop app / Codex IDE extension

All three share one config file: ~/.codex/config.toml. Configure once, use everywhere.

Easiest — let Codex write the entry:

codex mcp add vibe -- npx -y @vibebrowser/mcp

Or add the table to ~/.codex/config.toml by hand (Codex uses TOML, not JSON):

[mcp_servers.vibe]

command = "npx" args = ["-y", "@vibebrowser/mcp"]

In the ChatGPT desktop app you can also use the UI: Settings → MCP servers → Add server, choose STDIO, command npx, args -y @vibebrowser/mcp, then Restart.

Verify with codex mcp list, or type /mcp in the Codex