Skip to main content
MCP server CX Codex

Clearcote Browser — Claude Code MCP server: what it does

The Clearcote Browser MCP server for Claude Code controls a Chromium browser to read pages, click elements, and fill fields. It runs on browser tasks sent through an agent chat.

BSD-3-Clause ★ 273 updated 2026-11-13

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> --env CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> --env CLEARCOTE_PROXY=<CLEARCOTE_PROXY> --env CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> --env CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> --transport stdio mcp -- npx -y clearcote-mcp
Open on GitHub

What Clearcote Browser does

Clearcote Browser controls Chromium through MCP. It can open pages, return text or HTML, interact with page elements, fill forms, and capture screenshots. It also saves browser profiles with cookies and storage; get_cdp_endpoint lets other CDP clients attach to the same session.

Running it with npx requires Node.js. On first use, it downloads a Clearcote binary for Windows x64 or Linux x64. The Python option installs with pip install clearcote-mcp. By default, the server rejects private addresses and URL schemes other than http and https.

CLEARCOTE_API_KEY is required for cloud mode and the run_task tool; cloud mode also needs CLEARCOTE_CLOUD=1. A local setup can route traffic through CLEARCOTE_PROXY, while CLEARCOTE_GEOIP=1 derives timezone and language settings from the proxy IP.

What it helps with

  • read the contents of a web page
  • click a page element or fill a form field
  • save a page screenshot or PDF
  • connect another CDP client to the browser session

Example prompts for the agent

  • Read this page and return its contents as Markdown.
  • Find the sign-in button and click it.
  • Save the current page as a PDF.

How to install Clearcote Browser

Platform CLI

claude mcp add --env CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> --env CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> --env CLEARCOTE_PROXY=<CLEARCOTE_PROXY> --env CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> --env CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> --transport stdio mcp -- npx -y clearcote-mcp

Replace <…> with your own values. 1 more environment variable is in the server README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Clearcote Browser

How do I install Clearcote Browser in Claude Code?

Run: claude mcp add clearcote-mcp -e CLEARCOTE_PROXY=<CLEARCOTE_PROXY> -e CLEARCOTE_API_KEY=<CLEARCOTE_API_KEY> -- npx -y clearcote-mcp.

What does Clearcote Browser do?

It controls Chromium through an MCP client. The server can read pages, interact with elements, fill fields, and save screenshots or PDFs.

What does Clearcote Browser require?

The npx launcher needs Node.js. CLEARCOTE_API_KEY is required for cloud mode and run_task; cloud mode also requires CLEARCOTE_CLOUD=1.

Similar MCP servers

All MCP servers for Browser and scraping →

Project sponsors

Companies that keep this analytics open