sh6drack avatar

Zen Mcp

sh6drack/zen-mcp

This connects Claude to Zen Browser through WebDriver BiDi over WebSocket, no Selenium or Playwright needed. You get 20 tools covering navigation, tab management, form filling with proper event dispatch for React and Vue apps, screenshots, page text extraction, and JavaScript evaluation. It handles auto-reconnect with exponential backoff and zombie session recovery when connections drop. Point it at Zen running with the remote debugging flag on port 9222 and you can automate browsing workflows directly from Claude Desktop or Cursor. Useful if you're already running Zen and want Claude to drive web interactions without spinning up a separate automation framework.

GitHub stars
10
tools
20
transport
STDIO
env var
1
last updated
Mar 2, 2026

Tools

20 tools

Public tool metadata for what this MCP can expose to an agent.

zen_navigateGo to a URL

Go to a URL

No parameter schema in public metadata yet.

zen_list_pagesList all open tabs

List all open tabs

No parameter schema in public metadata yet.

zen_select_pageSwitch to a tab

Switch to a tab

No parameter schema in public metadata yet.

zen_new_tabOpen a new tab

Open a new tab

No parameter schema in public metadata yet.

zen_close_tabClose a tab

Close a tab

No parameter schema in public metadata yet.

zen_snapshotPage structure with selectors (filter: all/interactive/form)

Page structure with selectors (filter: all/interactive/form)

No parameter schema in public metadata yet.

zen_screenshotCapture a screenshot

Capture a screenshot

No parameter schema in public metadata yet.

zen_get_page_textGet page title, URL, and text

Get page title, URL, and text

No parameter schema in public metadata yet.

zen_get_form_fieldsList all form fields with labels and values

List all form fields with labels and values

No parameter schema in public metadata yet.

zen_clickClick an element

Click an element

No parameter schema in public metadata yet.

zen_fillType into an input or textarea

Type into an input or textarea

No parameter schema in public metadata yet.

zen_select_optionPick a dropdown option

Pick a dropdown option

No parameter schema in public metadata yet.

zen_checkToggle a checkbox or radio

Toggle a checkbox or radio

No parameter schema in public metadata yet.

zen_press_keyKeyboard input (Enter, Tab, Ctrl+A, etc.)

Keyboard input (Enter, Tab, Ctrl+A, etc.)

No parameter schema in public metadata yet.

zen_fill_formFill multiple fields at once

Fill multiple fields at once

No parameter schema in public metadata yet.

zen_scrollScroll the page or to an element

Scroll the page or to an element

No parameter schema in public metadata yet.

zen_evaluateRun JavaScript in the page

Run JavaScript in the page

No parameter schema in public metadata yet.

zen_waitWait N milliseconds

Wait N milliseconds

No parameter schema in public metadata yet.

zen_wait_forWait for text or element to appear

Wait for text or element to appear

No parameter schema in public metadata yet.

zen_reconnectForce reconnect to Zen

Force reconnect to Zen

No parameter schema in public metadata yet.

Sponsors

Configuration

ZEN_DEBUG_PORT

Zen Browser remote debugging port

Readme

zen-mcp

The first MCP server for Zen Browser. Automate Zen from Claude Code, Cursor, or any MCP client.

No Selenium. No Playwright. No browser drivers. Just WebSocket.

Setup (2 minutes)

1. Start Zen with remote debugging

/Applications/Zen.app/Contents/MacOS/zen --remote-debugging-port 9222

Pro tip: Add alias zen='open /Applications/Zen.app --args --remote-debugging-port 9222' to your shell config. Then just run zen.

2. Add to Claude Code

# Option A: npm (recommended)
npm install -g zen-mcp

# Option B: Clone
git clone https://github.com/sh6drack/zen-mcp.git && cd zen-mcp && npm install

Add to ~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "zen-browser": {
      "command": "zen-mcp"
    }
  }
}

If you cloned instead of npm install, use "command": "node", "args": ["/absolute/path/to/zen-mcp/server.mjs"]

Add to ~/.claude/settings.json:

{
  "permissions": {
    "allow": ["mcp__zen-browser__*"]
  }
}

That's it. Start a new Claude Code session and the zen_* tools are available.

20 Tools

Browse


View the full README on GitHub

Details

Repository
github.com/sh6drack/zen-mcp
Categories
Web & Browser Automation, Automation & Workflows
Package
zen-mcp
Transport
STDIO
Registry
MCP registry, active

Related Web & Browser Automation MCP servers

View all
1cherchyk avatarMCP Browsercherchyk/mcpbrowserBrowser automation using the user's Chromium session — JS execution, auth, and anti-bot support.9stars
2baixianger avatarCamoufox Mcpbaixianger/camoufox-mcpAnti-detection browser automation with Camoufox - stealth Firefox for web scraping7stars
3overtimepog avatarCloakmcpovertimepog/cloakmcpStealth browser MCP server — anti-detection Chromium with snapshot-first agent interface7stars
4sidebutton avatarSideButton MCP Serversidebutton/sidebuttonOpen-source MCP server with browser automation and knowledge packs for AI agents6stars
5wickproject avatarWickwickproject/wickBrowser-grade web access for AI agents. Fetches any webpage, returns clean markdown.6stars
6anthonybono21-cloud avatarLeapfroganthonybono21-cloud/leapfrogMulti-session browser MCP — 15 parallel isolated browsers, 37 tools, stealth, self-improvement.5stars