Repolode
Submit
jackwener

jackwener/BrowserMCP

An MCP browser service that lets AI agents operate your logged-in Chrome tabs through a local extension and host, with reusable site adapters.

View on GitHub
Stars
130
Forks
15
Open issues
4
Last commit
9 days ago

What is it?

BrowserMCP connects MCP clients such as Claude Code, Cursor and Codex to the Chrome browser you are already signed into. A Chrome extension and a local host, linked by Native Messaging, let agents read pages, search sites, fill forms and navigate using your existing session and cookies.

Agents work in a persistent JavaScript workspace where variables and tab handles survive between calls, following an observe, act, verify and finalize loop. Built-in site commands cover Twitter/X, Bilibili and Reddit, and developers can define their own site adapters as explicit, reusable MCP tools.

Agent-created tabs are placed in named groups and closed after the session, while tabs borrowed from the user are released rather than closed. Installation is through an npm package and a Chrome Web Store extension, with a setup command that registers the selected MCP clients.

Key features

  • 01Operates logged-in Chrome tabs through a local extension and host, using Native Messaging.
  • 02Persistent JavaScript REPL where variables and tab handles persist across calls.
  • 03Built-in site commands for Twitter/X, Bilibili and Reddit.
  • 04Site adapters can be defined as reusable, explicit MCP tools.
  • 05Agent-created tabs are grouped and cleaned up, while user tabs are never closed by session cleanup.
  • 06Local-only connections over stdio and Unix socket or named pipe, with no port configuration.

Use cases

  • Having an AI agent read or summarize pages on sites where you are already logged in.
  • Automating form filling or navigation in a browser session that requires existing sign-in.
  • Building a reusable tool that repeats a verified query workflow on a website.
  • Letting coding agents in Claude Code or Cursor use the browser for research tasks.

Quick start

  1. 1

    Install the BrowserMCP Connector Chrome extension from the Chrome Web Store

  2. 2

    Install the npm package globally

    npm install -g @jackwener/browsermcp
  3. 3

    Run setup to connect the extension and configure your MCP clients

    browsermcp setup
  4. 4

    Restart or reconnect your MCP client and ask it to use BrowserMCP

Things to know

  • Requires Node.js 22 or newer, Google Chrome, and an MCP client.
  • The extension requests powerful permissions including debugger, cookies, and access to all URLs.
  • Site commands run without additional approval prompts.

In collections

Browser automation for AI agentsOpen-source AI agent frameworks & appsMCP serversChrome & browser extensions

Topics

#mcp#browser-automation#chrome-extension#ai-agent#web-scraping#typescript#nodejs

FAQ

What is BrowserMCP?
An MCP browser service that lets AI agents operate your logged-in Chrome tabs through a local extension and host, with reusable site adapters. BrowserMCP connects MCP clients such as Claude Code, Cursor and Codex to the Chrome browser you are already signed into. A Chrome extension and a local host, linked by Native Messaging, let agents read pages, search sites, fill forms and navigate using your existing session and cookies.
Is BrowserMCP free to use? What license does it have?
BrowserMCP is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is BrowserMCP still maintained?
Actively maintained. The last commit to BrowserMCP was on Oct 29, 2026.
What can I use BrowserMCP for?
Having an AI agent read or summarize pages on sites where you are already logged in. Automating form filling or navigation in a browser session that requires existing sign-in. Building a reusable tool that repeats a verified query workflow on a website. Letting coding agents in Claude Code or Cursor use the browser for research tasks.
How do I install BrowserMCP?
Install the BrowserMCP Connector Chrome extension from the Chrome Web Store Install the npm package globally: npm install -g @jackwener/browsermcp Run setup to connect the extension and configure your MCP clients: browsermcp setup Restart or reconnect your MCP client and ask it to use BrowserMCP
Where can I get BrowserMCP?
The source code and installation instructions are on GitHub: https://github.com/jackwener/BrowserMCP

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects