Liberty Browser
Provides browser automation and navigation capabilities by controlling installed Google Chrome through Chrome DevTools Protocol, including tab management, navigation to HTTP/HTTPS sites, page inspection, and persistent signed-in sessions using a dedicated Chrome profile.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Liberty Browser
Liberty Browser is a local Python MCP server and CLI that controls installed Google Chrome through Chrome DevTools Protocol (CDP), using a dedicated persistent profile.
Open-web focus
Liberty Browser supports navigation across HTTP and HTTPS sites without a built-in website allowlist. Websites retain their own sign-in, verification, and access requirements.
Related MCP server: devtools-fleet-mcp
How it works
Run
liberty-browser loginto open installed Google Chrome with a dedicated profile for manual sign-in.Close the Chrome windows using that profile.
Call an MCP browser tool. Liberty Browser starts the same profile minimized in the background with loopback CDP, waits for readiness, verifies the process and profile, and connects without taking focus from your current app. Restore Chrome from the taskbar to follow along.
Playwright provides the CDP connection API. All browser actions use installed Google Chrome. Cookies and signed-in state remain in the local profile outside this repository.
Requirements
Windows
Python 3.10 or newer
Google Chrome installed
Install
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install "git+https://github.com/andrey-barros-dev/liberty-browser.git"
.\.venv\Scripts\Activate.ps1MCP configuration
{
"mcpServers": {
"liberty-browser": {
"command": "liberty-browser-mcp",
"args": []
}
}
}Use the absolute path to .venv/Scripts/liberty-browser-mcp.exe when the command is not on PATH. liberty-browser-codex is a compatibility alias for the same persistent Chrome MCP runtime. MCP messages use stdio.
CLI
liberty-browser login
liberty-browser tabs list
liberty-browser navigate https://example.com
liberty-browser inspect
liberty-browser shellBrowser actions automatically launch or reconnect to the dedicated Chrome profile. Closing the MCP connection leaves Chrome running.
Downloads triggered in Chrome use the download settings of the dedicated profile. Chrome handles download prompts, naming, and security checks.
Evaluate JavaScript
The evaluate_script MCP tool runs a JavaScript function in the selected page and returns its result. For example, use {"function": "() => document.title"}. Functions can be asynchronous, and the optional args array supplies positional arguments: {"function": "(a, b) => a + b", "args": [2, 3]}. Return JSON-compatible values. Scripts run with the current page's session and can modify it.
Upload files
Use inspect_page to find file inputs, including hidden input[type=file] controls. Then call the upload_file MCP tool with the input selector and one or more absolute local file paths. If the selector is a button that opens the file chooser, Liberty Browser captures that chooser and supplies the files directly through Playwright.
upload_file accepts up to 20 regular files at a time. The default per-file limit is 256 MiB; set BROWSER_MCP_MAX_UPLOAD_BYTES to change it. Selecting files makes them available to the current page, which may upload or process them, so call this tool only for files and destinations the user has requested.
Configuration
Variable | Purpose | Default |
| Dedicated persistent Chrome profile |
|
| Loopback CDP port |
|
| Browser action timeout |
|
| MCP Chrome window mode: |
|
Development
python -m pip install -e ".[test]"
python -m pytest -qTests use temporary Chrome profiles and local fixture pages. See Architecture, Contributing, and Security.
Privacy and security
The persistent profile contains browser session data. Keep it private and outside source control. A connected MCP client can act with that session's permissions. Website verification remains under the website's control.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Loxo MCP server for ChatGPT, Claude and any AI agent: list jobs, read a job pipeline, search people, log candidate activity, move candidate to a stage, email a pipeline stage, read the activity report and create person in your own Loxo account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Loxo yourself; Cotlet does not store your password and you need no Loxo API key. About the official Loxo API: Yes, Loxo has an Open API, but it is a paid feature: Loxo Support turns on the Settings > API Keys page for your account, and only account admins can use it (checked 22 Oct 2026). Loxo has no official MCP server, and its API reference has no endpoints for reports or for sending email. Setup and FAQ: https://cotlet.dev/integrations/loxo-api-mcp-server
LinkedIn MCP server for ChatGPT, Claude and any AI agent: create post, comment on post, send message, send connection invitation, search people, search companies, list connections and read conversations in your own LinkedIn account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to LinkedIn yourself; Cotlet does not store your password and you need no LinkedIn API key. About the official LinkedIn API: LinkedIn has an official API, but most of it needs an approved application (checked 6 Nov 2026). The open Share on LinkedIn permission lets an app post, comment and like on behalf of a member. Setup and FAQ: https://cotlet.dev/integrations/linkedin-api-mcp-server
Plex MCP server for ChatGPT, Claude and any AI agent: search libraries, list library items, add to Watchlist, mark item watched, add to playlist, list collections, grant library access and revoke library access in your own Plex account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Plex yourself; Cotlet does not store your password and you need no Plex API key. About the official Plex API: Plex has a documented HTTP API for Plex Media Server and no official MCP server (checked 5 Nov 2026). The API covers libraries, playlists, collections and playback history on one server and needs an X-Plex-Token. Setup and FAQ: https://cotlet.dev/integrations/plex-api-mcp-server
Riverside MCP server for ChatGPT, Claude and any AI agent: create studio, schedule session, invite guest and download recording in your own Riverside account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Riverside yourself; Cotlet does not store your password and you need no Riverside API key. About the official Riverside API: Riverside has a Business API for select Business accounts only, with a key from your customer success manager, and it mostly gets or deletes recordings and lists scheduled events (checked 11 Oct 2026). Its official MCP server (beta, Grow, Webinar and Business plans) searches, edits and posts clips, but cannot schedule sessions or invite guests. Setup and FAQ: https://cotlet.dev/integrations/riverside-api-mcp-server
Related MCP Servers
- AlicenseAqualityDmaintenanceDrives your real local Chrome with profile isolation, allowing LLMs to interact with your logged-in sessions without modifying your actual profile.1348 npmMIT
- AlicenseBqualityBmaintenanceEnables multiple AI agents to each run Google's full Chrome DevTools toolset in an isolated Chrome instance with saved logins, origin allowlists, reconnect recovery, and process cleanup. It also provides visibility into running browsers so stale sessions can be inspected or reaped.3885 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to control an existing signed-in Chrome profile through MCP stdio, using its current tabs, cookies, and logins without pairing or a separate browser. It exposes tab management, page interaction, screenshots, and Chrome DevTools Protocol commands.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to drive isolated, persistent Chromium browser profiles — each with its own cookies, fingerprint, and proxy — so they can complete real authenticated web workflows such as navigation, clicking, typing, extraction, screenshots, and JavaScript evaluation through a local endpoint.MIT