🍪 TabNab
Give your AI your cookies, without giving it your password
Local MCP server that bridges AI agents with authenticated browser sessions
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
Local MCP server that bridges AI agents with authenticated browser sessions
🍪 TabNab - Local MCP server that gives AI agents (Claude, Cursor, Windsurf) access to your authenticated browser sessions. Grab DOM, fill forms, and click through Cloudflare, all from your real Chromium browser with your real cookies. Give your AI your cookies, without giving it your password.
TabNab bridges the gap between AI agents (Claude, Cursor, Windsurf) and your real browser sessions. Instead of asking you to share passwords or API keys, TabNab lets AI agents use your existing authenticated browser sessions to:
The magic: AI agents see what you see in Chrome, using your cookies and sessions, without ever knowing your passwords.
Connect to your real Chrome browser with all your cookies & sessions intact via Playwright (CDP). No password sharing required.
Uses Readability.js + Turndown to convert messy HTML into pristine Markdown for AI consumption.
Complete browser automation via MCP protocol: tabs, navigation, extraction, query, keyboard, screenshots, and confirmations.
npm install -g pnpm)Recommendation: Use a dedicated Chrome profile for TabNab automation to isolate cookies and session data.
./scripts/start-chrome.sh
# or manually (dedicated profile recommended):
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir="$HOME/Library/Application Support/TabNab-Chrome"
./scripts/start-chrome.sh
# or manually (dedicated profile recommended):
google-chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.config/tabnab-chrome"
.\scripts\start-chrome.ps1
# or manually (dedicated profile recommended):
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%LOCALAPPDATA%\TabNabChrome"
git clone https://github.com/clduab11/tabnab.git
cd tabnab
pnpm install
pnpm run build
TabNab uses Playwright to attach to your existing Chrome via CDP. No extra browser download is required.
pnpm run test:milestone1
✅ You should see your active tab's URL and title!
Configure TabNab as an MCP server in your AI agent client.
File Location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonConfiguration:
{
"mcpServers": {
"tabnab": {
"command": "node",
"args": ["/absolute/path/to/tabnab/dist/mcp/index.js"],
"env": {
"CHROME_DEBUG_PORT": "9222",
"TABNAB_ALLOWED_DOMAINS": "example.com,app.example.com",
"TABNAB_CONFIRMATION_MODE": "confirm-on-sensitive",
"TABNAB_AUDIT_LOG_PATH": "/tmp/tabnab-audit.log"
}
}
}
}
Follow similar configuration patterns for other MCP-compatible clients. See mcp-config.example.json for reference.
pnpm run dev
Launches TabNab as a menu bar application.
TabNab provides a focused set of MCP tools for browser automation with policy enforcement:
All tool responses follow a shared contract:
{
"ok": true,
"success": true,
"protocolVersion": 2,
"warnings": [],
"data": {}
}
Errors use the same envelope with ok: false, an error object, and success: false for backward compatibility.
Use list_tabs to obtain stable tabId values. Every page/action tool accepts an optional tabId. If omitted, TabNab chooses the active tab by preferring the focused tab (if detectable), falling back to the last focused tab, and then the first non-extension/non-devtools tab.
When a policy decision requires confirmation, tools return:
{
"ok": false,
"success": false,
"protocolVersion": 2,
"warnings": [],
"error": { "code": "NEEDS_CONFIRMATION", "message": "..." },
"data": { "confirmationId": "...", "actionSummary": "..." }
}
Call confirm_action with the confirmationId, then retry the original action with confirmationId to proceed. Use deny_action to reject the pending action.
Returns the URL and title of the currently active browser tab.
Example Output:
{
"ok": true,
"data": {
"url": "https://github.com/clduab11/tabnab",
"title": "TabNab - GitHub"
},
"warnings": []
}
Navigate to a URL and extract clean Markdown content using Readability.js (or sanitized DOM).
Example Input:
{
"url": "https://example.com/article",
"extractionMode": "readability_markdown"
}
Example Output:
{
"ok": true,
"data": {
"url": "https://example.com/article",
"title": "Article Title",
"markdown": "# Article Title\n\nClean extracted content..."
},
"warnings": []
}
Click an element on the current page using a CSS selector.
Example Input:
{
"selector": "button.submit-btn"
}
Example Output:
{
"ok": true,
"data": {
"message": "Clicked element: button.submit-btn"
},
"warnings": []
}
Fill an input field with the specified value. Clears existing content first.
Example Input:
{
"selector": "input[name='email']",
"value": "[email protected]"
}
Example Output:
{
"ok": true,
"data": {
"message": "Filled input: input[name='email']"
},
"warnings": []
}
Take a screenshot of the current tab. Returns base64-encoded data if no path specified.
Example Input:
{
"fullPage": false,
"path": "/path/to/screenshot.png"
}
Example Output:
{
"ok": true,
"data": {
"path": "/path/to/screenshot.png",
"message": "Screenshot saved to: /path/to/screenshot.png"
},
"warnings": []
}
TabNab enforces a domain allowlist and confirmation gates by default. Actions that are blocked return ok: false with reasonCodes.
Environment Variables:
TABNAB_ALLOWED_DOMAINS="example.com,app.example.com" (required for navigation/click/fill)TABNAB_ALLOWED_PATH_PREFIXES="example.com:/billing;example.com:/settings"TABNAB_CONFIRMATION_MODE="auto|confirm-on-navigation|confirm-on-sensitive|always-confirm"TABNAB_AUDIT_LOG_PATH="/tmp/tabnab-audit.log"TABNAB_AUDIT_LOG_SELECTOR_MODE="truncate|hash|plaintext"TABNAB_MAX_STEPS="30"Confirmation Flow:
status: "needs_confirmation" with a confirmation_token.confirm_action to proceed or cancel.Prompt-Injection Warnings: Extraction tools scan extracted content for instruction-like phrases and return warnings when detected.
graph TB
A[AI Agent<br/>Claude/Cursor/Windsurf] -->|MCP Protocol| B[TabNab MCP Server]
B -->|Chrome DevTools Protocol| C[Chrome Browser<br/>Port 9222]
C -->|Authenticated Sessions| D[Web Pages<br/>With Your Cookies]
style A fill:#e1f5ff,stroke:#01579b,stroke-width:2px
style B fill:#fff9c4,stroke:#f57f17,stroke-width:2px
style C fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
style D fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
Architecture Overview:
/src
/main - Electron menu bar application entry point
/mcp - MCP server implementation (stdio transport)
/browser - Chrome DevTools Protocol connection manager (Playwright CDP)
/extraction - HTML to Markdown conversion (Readability + Turndown)
Let Claude or Cursor automate tedious browser tasks using your existing sessions:
Gather information from sites where you're already logged in:
Automate browser testing with real authentication:
Browse and analyze content with AI assistance:
We welcome contributions! See CONTRIBUTING.md for:
Before contributing, please review our:
# Install dependencies
pnpm install
# Build project
pnpm run build
# Run type checking
pnpm run type-check
# Lint code
pnpm run lint
# Auto-fix linting issues
pnpm run lint:fix
# Format code
pnpm run format
# Run Electron app
pnpm run dev
TabNab is available under a dual-license model:
Free under the PolyForm Shield License 1.0.0
✅ Allowed:
Requires a commercial license for any profit-generating activity:
❗ Requires License:
See our Commercial License FAQ for detailed examples and guidance.
Contact for Commercial Licensing:
TabNab provides AI agents with powerful access to your authenticated browser sessions. Please understand the implications:
localhost Chrome instancesBest Practices:
Report Security Issues: [email protected] (placeholder)
Built with:
Made with ❤️ for the AI automation community
TabNab © 2025 TabNab Contributors
🍪 TabNab - Local MCP server that gives AI agents (Claude, Cursor, Windsurf) access to your authenticated browser sessions. Grab DOM, fill forms, and click through Cloudflare, all from your real Chrom
Overview
🍪 TabNab - Local MCP server that gives AI agents (Claude, Cursor, Windsurf) access to your authenticated browser sessions. Grab DOM, fill forms, and click through Cloudflare, all from your real Chromium browser with your real cookies. Give your AI your cookies, without giving it your password.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Tabnab runs locally over stdio.
Last checked 2026-10-28. 🍪 TabNab - Local MCP server that gives AI agents (Claude, Cursor, Windsurf) access to your authenticated browser sessions. Grab DOM, fill forms, and click through Cloudflare, all from your real Chromium browser with your real cookies. Give your AI your cookies, without giving it your password.