Chrome MCP Server
About
Exposes Chrome browser functionality to AI assistants for automation, content analysis, and semantic search via a Chrome extension.
Details
- Author
- hangwin
- Categories
- Web Scraping, Automation, Other
Jump to
Setup
Install Chrome MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/hangwin/mcp-chrome
Follow the installation instructions in the repository README, then restart your MCP client.
πTurn your Chrome browser into your intelligent assistant- Let AI take control of your browser, transforming it into a powerful AI-controlled automation tool.
The project is still in its early stages and is under intensive development. More features, stability improvements, and other enhancements will follow.
Chrome MCP Server is a Chrome extension-basedModel Context Protocol (MCP) serverthat exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search. Unlike traditional browser automation tools (like Playwright),Chrome MCP Serverdirectly uses your daily Chrome browser, leveraging existing user habits, configurations, and login states, allowing various large models or chatbots to take control of your browser and truly become your everyday assistant.
- A New Visual Editor for Claude Code & Codex, for more detail here:VisualEditor
- πChatbot/Model Agnostic: Let any LLM or chatbot client or agent you prefer automate your browser
- βοΈUse Your Original Browser: Seamlessly integrate with your existing browser environment (your configurations, login states, etc.)
- π»Fully Local: Pure local MCP server ensuring user privacy
- πStreamable HTTP: Streamable HTTP connection method
- πCross-Tab: Cross-tab context
- π§ Semantic Search: Built-in vector database for intelligent browser tab content discovery
- πSmart Content Analysis: AI-powered text extraction and similarity matching
- π20+ Tools: Support for screenshots, network monitoring, interactive operations, bookmark management, browsing history, and 20+ other tools
- πSIMD-Accelerated AI: Custom WebAssembly SIMD optimization for 4-8x faster vector operations
- Node.js >= 20.0.0 and pnpm/npm
- Chrome/Chromium browser
- Download the latest Chrome extension from GitHub
Download link:https://github.com/hangwin/mcp-chrome/releases
# Method 1: Enable scripts globally (recommended) pnpm config set enable-pre-post-scripts true pnpm install -g mcp-chrome-bridge # Method 2: Manual registration (if postinstall doesn't run) pnpm install -g mcp-chrome-bridge mcp-chrome-bridge register
Note: pnpm v7+ disables postinstall scripts by default for security. Theenable-pre-post-scriptssetting controls whether pre/post install scripts run. If automatic registration fails, use the manual registration command above.
- Load Chrome Extension
- Open Chrome and go tochrome://extensions/
- Enable "Developer mode"
- Click "Load unpacked" and selectyour/dowloaded/extension/folder
- Click the extension icon to open the plugin, then click connect to see the MCP configuration
Using Streamable HTTP Connection (ππ» Recommended)
Add the following configuration to your MCP client configuration (using CherryStudio as an example):
Streamable HTTP connection method is recommended
{ "mcpServers": { "chrome-mcp-server": { "type": "streamableHttp", "url": "http://127.0.0.1:12306/mcp" } } }
If your client only supports stdio connection method, please use the following approach:
- First, check the installation location of the npm package you just installed
# npm check method npm list -g mcp-chrome-bridge # pnpm check method pnpm list -g mcp-chrome-bridge
Assuming the command above outputs the path: /Users/xxx/Library/pnpm/global/5 Then your final path would be: /Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js
- Replace the configuration below with the final path you just obtained
{ "mcpServers": { "chrome-mcp-stdio": { "command": "npx", "args": [ "node", "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js" ] } } }
- get_windows_and_tabs- List all browser windows and tabs
- chrome_navigate- Navigate to URLs and control viewport
- chrome_switch_tab- Switch the current active tab
- chrome_close_tabs- Close specific tabs or windows
- chrome_go_back_or_forward- Browser navigation control
- chrome_inject_script- Inject content scripts into web pages
- chrome_send_command_to_inject_script- Send commands to injected content scripts
- chrome_screenshot- Advanced screenshot capture with element targeting, full-page support, and custom dimensions
- chrome_network_capture_start/stop- webRequest API network capture
- chrome_network_debugger_start/stop- Debugger API with response bodies
- chrome_network_request- Send custom HTTP requests
- search_tabs_content- AI-powered semantic search across browser tabs
- chrome_get_web_content- Extract HTML/text content from pages
- chrome_get_interactive_elements- Find clickable elements
- chrome_console- Capture and retrieve console output from browser tabs
- chrome_click_element- Click elements using CSS selectors
- chrome_fill_or_select- Fill forms and select options
- chrome_keyboard- Simulate keyboard input and shortcuts
- chrome_history- Search browser history with time filters
- chrome_bookmark_search- Find bookmarks by keywords
- chrome_bookmark_add- Add new bookmarks with folder support
- chrome_bookmark_delete- Delete bookmarks
AI helps you summarize webpage content and automatically control Excalidraw for drawing
prompt:excalidraw-promptInstruction: Help me summarize the current page content, then draw a diagram to aid my understanding.https://www.youtube.com/watch?v=3fBPdUBWVz0
https://github.com/user-attachments/assets/fd17209b-303d-48db-9e5e-3717141df183
After analyzing the content of the image, the LLM automatically controls Excalidraw to replicate the image
prompt:excalidraw-prompt|content-analizeInstruction: First, analyze the content of the image, and then replicate the image by combining the analysis with the content of the image.https://www.youtube.com/watch?v=tEPdHZBzbZk
https://github.com/user-attachments/assets/60d12b1a-9b74-40f4-994c-95e8fa1fc8d3
AI automatically injects scripts and modifies webpage styles
prompt:modify-web-promptInstruction: Help me modify the current page's style and remove advertisements.https://youtu.be/twI6apRKHsk
https://github.com/user-attachments/assets/69cb561c-2e1e-4665-9411-4a3185f9643e
AI automatically captures network requests for you
query: I want to know what the search API for Xiaohongshu is and what the response structure looks like
https://github.com/user-attachments/assets/dc7e5cab-b9af-4b9a-97ce-18e4837318d9
query: Analyze my browsing history from the past month
https://github.com/user-attachments/assets/31b2e064-88c6-4adb-96d7-50748b826eae
query: Translate and summarize the current web pagehttps://youtu.be/FlJKS9UQyC8
https://github.com/user-attachments/assets/aa8ef2a1-2310-47e6-897a-769d85489396
AI automatically takes screenshots for you (web page screenshots)
query: Take a screenshot of Hugging Face's homepagehttps://youtu.be/7ycK6iksWi4
https://github.com/user-attachments/assets/65c6eee2-6366-493d-a3bd-2b27529ff5b3
AI automatically takes screenshots for you (element screenshots)
query: Capture the icon from Hugging Face's homepagehttps://youtu.be/ev8VivANIrk
https://github.com/user-attachments/assets/d0cf9785-c2fe-4729-a3c5-7f2b8b96fe0c
query: Add the current page to bookmarks and put it in an appropriate folder
https://github.com/user-attachments/assets/15a7d04c-0196-4b40-84c2-bafb5c26dfe0
query: Close all shadcn-related web pages
https://github.com/user-attachments/assets/83de4008-bb7e-494d-9b0f-98325cfea592
We welcome contributions! Please seeCONTRIBUTING.mdfor detailed guidelines.
We have exciting plans for the future development of Chrome MCP Server:
- Authentication
- Recording and Playback
- Workflow Automation
- Enhanced Browser Support (Firefox Extension)
Want to contribute to any of these features?Check out ourContributing Guideand join our development community!
This project is licensed under the MIT License - see theLICENSEfile for details.
- Architecture Design- Detailed technical architecture documentation
- TOOLS API- Complete tool API documentation
- Troubleshooting- Common issue solutions
MCP server for browser automation via Vercel agent-browser CLI
Convert any URL to LLM-ready Markdown via real Chrome browsers. 3 tools: scrape, crawl, search. Free via MCP, pay-per-use via x402.
An MCP server that allows AI agents to control a web browser using the browser-use library.
Control a Chrome browser through the Chrome DevTools Protocol (CDP) from MCP clients for browsing, inspection, and automation workflows.
Stealthy, LLM-drivable browser engine β a Python library + 85-tool MCP server on stealth Chromium with full Chrome DevTools Protocol.
Multi-session browser MCP for AI agents β stealth mode, session pooling, humanization, 10x fewer tokens than Playwright
A Go-based MCP server for interacting with the Lightpanda Browser using the Chrome DevTools Protocol (CDP).
A browser automation agent using the Model Context Protocol (MCP) to enable browser interactions.
A browser automation service for capturing console output, useful for tasks like public sentiment analysis.
Control the Chrome browser for web automation using an AI model. Requires the MCP Chrome extension.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


