FlowLens
FlowLens is an open-source MCP server that gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.
What is FlowLens?
FlowLens is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to flowlens is an open-source mcp server that gives your coding agent (claude code, cursor, copilot, codex) full browser context for in-depth debugging and regression testing.
FlowLens is an open-source MCP server that gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- FlowLens is an open-source MCP server that gives your coding
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx flowlensConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use FlowLens
FlowLens is an open-source MCP server that connects AI coding agents — including Claude Code, Cursor, GitHub Copilot, and Codex — to a Chrome extension that captures full browser context during development. When a bug occurs or a flow needs testing, FlowLens collects user actions, network requests, console logs, DOM events, storage data, and screen recordings in real time, then makes all of that context available to the AI agent via MCP tools. This replaces the tedious cycle of manually gathering logs and screenshots by giving the AI agent the same information a developer sees in DevTools.
Prerequisites
- Python 3.10 or later and pipx installed
- Google Chrome with the FlowLens extension installed
- An MCP-compatible client: Claude Code, VS Code with Copilot, Cursor, or Codex CLI
- A FlowLens account and FLOWLENS_MCP_TOKEN (required only for shareable flows; optional for local-only usage)
Install the FlowLens MCP server
Use pipx to install the server as an isolated Python application so it does not conflict with other Python environments.
pipx install flowlens-mcp-serverInstall the FlowLens Chrome extension
Visit the FlowLens platform and follow the setup wizard to install the Chrome extension. The extension is what captures browser context and forwards it to the MCP server.
Add the server to your MCP client
Configure your MCP client to run the flowlens-mcp-server command. For Claude Code, use the CLI shortcut; for other clients, edit the config JSON manually.
claude mcp add flowlens --transport stdio -- flowlens-mcp-serverConfigure with a token for shareable flows (optional)
If you want to share captured flows with teammates via the FlowLens platform, add your FLOWLENS_MCP_TOKEN to the server environment. Obtain the token from the FlowLens setup wizard.
{
"mcpServers": {
"flowlens": {
"command": "flowlens-mcp-server",
"type": "stdio",
"env": {
"FLOWLENS_MCP_TOKEN": "YOUR_FLOWLENS_MCP_TOKEN"
}
}
}
}Record a flow and debug with AI
Start the Chrome extension, reproduce a bug or user flow in the browser, then ask your AI agent to analyze the captured context. The agent receives actions, network logs, console output, and DOM events automatically.
FlowLens Examples
Client configuration
Basic claude_desktop_config.json entry for FlowLens without a platform token (local-only mode).
{
"mcpServers": {
"flowlens": {
"command": "flowlens-mcp-server",
"type": "stdio"
}
}
}Prompts to try
These prompts work after you have recorded a flow with the Chrome extension.
- "Analyze the captured flow and identify what caused the checkout error"
- "Look at the network requests in this flow and find any failed API calls"
- "Generate a Playwright test script that reproduces the user flow I just recorded"
- "Check the console logs from this flow and explain any JavaScript errors"Troubleshooting FlowLens
flowlens-mcp-server command not found after pipx install
Run pipx ensurepath to add the pipx bin directory to your PATH, then open a new terminal session.
Chrome extension is not sending data to the MCP server
Ensure both the MCP server and the Chrome extension are running. The extension communicates over a local WebSocket; check that no firewall or browser policy is blocking localhost connections.
FLOWLENS_MCP_TOKEN is rejected or flows fail to upload
Re-run the FlowLens setup wizard to obtain a fresh token. Tokens are scoped to your account; make sure the token in your config matches the one shown in your FlowLens dashboard.
Frequently Asked Questions about FlowLens
What is FlowLens?
FlowLens is a Model Context Protocol (MCP) server that flowlens is an open-source mcp server that gives your coding agent (claude code, cursor, copilot, codex) full browser context for in-depth debugging and regression testing. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install FlowLens?
Follow the installation instructions on the FlowLens GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with FlowLens?
FlowLens works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is FlowLens free to use?
Yes, FlowLens is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
FlowLens Alternatives — Similar Browser Automation Servers
Looking for alternatives to FlowLens? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up FlowLens in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use FlowLens?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.