TabNab

What it does

TabNab is a local MCP server that bridges AI agents (Claude, Cursor, Windsurf) with your real Chrome browser via the Chrome DevTools Protocol. Instead of sharing credentials, TabNab lets agents leverage your existing authenticated sessions to navigate protected pages, extract clean content, fill forms, and automate multi-step workflows — all using your actual cookies without ever exposing your passwords.

Tools

• get_active_tab — Returns the URL and title of the currently active tab.
• list_tabs — Lists all open browser tabs with IDs, URLs, and titles.
• activate_tab — Switches the active tab by tab ID.
• navigate_and_extract — Navigates to a URL and returns clean Markdown content via Readability.js + Turndown.
• click_element — Clicks a DOM element by CSS selector.
• fill_input — Fills an input field with a specified value.
• keyboard_type / press_key — Types text or sends keypresses to the active page.
• wait_for_selector / wait_for_navigation — Waits for UI state before continuing.
• query_selector_all — Extracts structured data from lists or tables.
• screenshot_tab — Captures a screenshot (viewport or full page).
• confirm_action / deny_action — Approves or rejects pending policy-gated actions.
• reset_session — Resets the step counter for a fresh automation session.

Installation

Requires Node.js 22+, pnpm, and Chrome launched with remote debugging:

git clone https://github.com/clduab11/tabnab.git
cd tabnab && pnpm install && pnpm run build

Start Chrome with debugging enabled:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tabnab": {
      "command": "node",
      "args": ["/absolute/path/to/tabnab/dist/mcp/index.js"],
      "env": {
        "CHROME_DEBUG_PORT": "9222",
        "TABNAB_ALLOWED_DOMAINS": "example.com",
        "TABNAB_CONFIRMATION_MODE": "confirm-on-sensitive"
      }
    }
  }
}

Supported hosts

Confirmed in README: Claude Desktop, Cursor, Windsurf.