
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 toolsPublic 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_PORTZen 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 runzen.
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
Details
- Repository
- github.com/sh6drack/zen-mcp
- Categories
- Web & Browser Automation, Automation & Workflows
- Package
zen-mcp- Transport
- STDIO
- Registry
- MCP registry, active