# Clearcote Browser

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 273 repo stars
- Author: clearcotelabs
- License: BSD-3-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clearcotelabs/clearcote-browser/tree/HEAD/mcp
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/clearcote-browser

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CLEARCOTE_FINGERPRINT`, `CLEARCOTE_PLATFORM`, `CLEARCOTE_PROXY`, `CLEARCOTE_GEOIP`, `CLEARCOTE_CLOUD`, `CLEARCOTE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
codex mcp add mcp --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> -- npx -y clearcote-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "clearcote-mcp"
            ],
            "env": {
                "CLEARCOTE_FINGERPRINT": "<CLEARCOTE_FINGERPRINT>",
                "CLEARCOTE_PLATFORM": "<CLEARCOTE_PLATFORM>",
                "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
                "CLEARCOTE_GEOIP": "<CLEARCOTE_GEOIP>",
                "CLEARCOTE_CLOUD": "<CLEARCOTE_CLOUD>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "clearcote-mcp"
            ],
            "env": {
                "CLEARCOTE_FINGERPRINT": "<CLEARCOTE_FINGERPRINT>",
                "CLEARCOTE_PLATFORM": "<CLEARCOTE_PLATFORM>",
                "CLEARCOTE_PROXY": "<CLEARCOTE_PROXY>",
                "CLEARCOTE_GEOIP": "<CLEARCOTE_GEOIP>",
                "CLEARCOTE_CLOUD": "<CLEARCOTE_CLOUD>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CLEARCOTE_FINGERPRINT=<CLEARCOTE_FINGERPRINT> -e CLEARCOTE_PLATFORM=<CLEARCOTE_PLATFORM> -e CLEARCOTE_PROXY=<CLEARCOTE_PROXY> -e CLEARCOTE_GEOIP=<CLEARCOTE_GEOIP> -e CLEARCOTE_CLOUD=<CLEARCOTE_CLOUD> mcp npx -y clearcote-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- 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
- Read this page and return its contents as Markdown.
- Find the sign-in button and click it.
- Save the current page as a PDF.

## Similar
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1600000 installs
- [Cognitive Browser](https://affpapa.org/en/nevibecode/mcp/cognitive-browser.md) — MCP server · 19566 installs
- [anti-detect-browser](https://affpapa.org/en/nevibecode/skills/anti-detect-browser.md) — skill · 168800 installs
- [browser-mcp-agent](https://affpapa.org/en/nevibecode/skills/browser-mcp-agent.md) — skill · 138200 installs
- [browser-fingerprint-audit](https://affpapa.org/en/nevibecode/skills/browser-fingerprint-audit.md) — skill · 132900 installs
- [browser-act](https://affpapa.org/en/nevibecode/skills/browser-act.md) — skill · 108500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
