whatisgithub

What is mcp-chrome?

hangwin/mcp-chrome — explained in plain English

Analysis updated 2026-06-24

11,612TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Chrome extension that lets AI assistants like Claude control your real Chrome browser, clicking, navigating, taking screenshots, and searching history, while keeping you logged in to all your existing accounts.

Mindmap

mindmap
  root((repo))
    What it does
      AI controls Chrome browser
      MCP protocol bridge
      Works in real profile
    Capabilities
      Open URLs and click
      Screenshots any tab
      Semantic tab search
      Bookmarks and history
    How it works
      Chrome extension
      Local bridge npm package
      WebAssembly vector search
    Setup needs
      Developer mode Chrome
      mcp-chrome-bridge install
      MCP-compatible AI client
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant navigate and interact with sites you are already signed in to, without re-entering passwords.

USE CASE 2

Use an AI to take screenshots of open tabs, search browser history, and manage bookmarks automatically.

USE CASE 3

Enable semantic search across all open tabs so an AI can find relevant content by meaning rather than exact keywords.

What is it built with?

TypeScriptChrome Extension APIWebAssemblynpm

How does it compare?

hangwin/mcp-chromeget-convex/convex-backendaisouler/gkd_subscription
Stars11,61211,58811,583
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing the Chrome extension in developer mode and running mcp-chrome-bridge as an npm package alongside your MCP-compatible AI client.

MIT license: use, copy, modify, and distribute freely for any purpose including commercial use, as long as you keep the copyright notice.

So what is it?

Chrome MCP Server is a Chrome browser extension that lets AI assistants control your Chrome browser directly. It works by implementing the Model Context Protocol (MCP), which is a standard way for AI tools like Claude to communicate with external software. Once the extension is installed and a small bridge program is running on your computer, an AI assistant can open URLs, click things, take screenshots, search your history, manage bookmarks, and more, all through your existing Chrome window. The key difference from older browser automation tools is that this extension runs inside your real Chrome profile. That means the AI is working in the same browser where you are already signed in to your accounts, and with your saved preferences and extensions in place. Traditional automation tools typically launch a fresh, empty browser instance where you would need to log in again to every site. The extension includes over 20 tools covering browser management, screenshots, page interaction, bookmarks, history, and a semantic search feature that uses a vector database to find relevant content across your open tabs. The semantic search is accelerated using a custom WebAssembly SIMD optimization that the README says produces a 4x to 8x speed improvement for the underlying vector operations. Setup requires installing the Chrome extension manually in developer mode, then installing a companion npm package called mcp-chrome-bridge. Once both are running, you point your MCP-compatible AI client at a local HTTP address and the browser tools become available to it. The project is MIT licensed and still described as being in early-stage development.

Copy-paste prompts

Prompt 1
I installed the mcp-chrome extension and the mcp-chrome-bridge npm package. Help me configure Claude Desktop to connect to it so I can control Chrome from Claude.
Prompt 2
Show me how to use the mcp-chrome browser tools to have an AI automatically fill a web form on a site where I am already logged in.
Prompt 3
I want to use mcp-chrome semantic tab search. Explain how the vector database works and how to trigger a semantic search from an AI prompt.
Prompt 4
Walk me through the mcp-chrome-bridge setup on Windows, where does the config file go and what port does the local bridge server listen on?

Frequently asked questions

What is mcp-chrome?

A Chrome extension that lets AI assistants like Claude control your real Chrome browser, clicking, navigating, taking screenshots, and searching history, while keeping you logged in to all your existing accounts.

What language is mcp-chrome written in?

Mainly TypeScript. The stack also includes TypeScript, Chrome Extension API, WebAssembly.

What license does mcp-chrome use?

MIT license: use, copy, modify, and distribute freely for any purpose including commercial use, as long as you keep the copyright notice.

How hard is mcp-chrome to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mcp-chrome for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.