cdpilot — Claude Code MCP server for browser control
cdpilot lets an AI agent control a browser through CDP. Use it to navigate pages, interact with elements, and capture screenshots.
claude mcp add cdpilot -- npx -y cdpilotWhat cdpilot does
The server gives an agent commands to open pages, click controls, enter text, and take screenshots in a separate browser profile. It also offers tools for inspecting network activity, console output, and accessibility. Browser control uses CDP rather than Puppeteer, Playwright, or Selenium.
You need Node.js 18+, Python 3.10+, and Brave Browser, Google Chrome, or Chromium. A preflight wizard installs Python’s websockets module on the first launch. Automation runs locally in an isolated profile, so a supported browser must be available to start a session.
What it helps with
- open a page in an isolated browser profile
- click a page element and fill in a form
- capture a screenshot after navigation
- inspect console output and network requests
Example prompts for the agent
- Open
https://example.comand take a screenshot. - Go to the sign-in page, fill in the form, and submit it.
- Inspect network requests and console output after the page loads.
How to install cdpilot
Platform CLI
claude mcp add cdpilot -- npx -y cdpilotPlatform CLI
codex mcp add cdpilot -- npx -y cdpilotConfig file
{
"mcpServers": {
"cdpilot": {
"command": "npx",
"args": [
"-y",
"cdpilot"
]
}
}
}Config file
{
"servers": {
"cdpilot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cdpilot"
]
}
}
}Platform CLI
gemini mcp add cdpilot npx -y cdpilotStep 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 cdpilot
How do I install cdpilot in Claude Code?
Run claude mcp add cdpilot -- npx -y cdpilot. You also need Node.js 18+, Python 3.10+, and Brave Browser, Google Chrome, or Chromium.
What does cdpilot do?
It gives an AI agent browser-control commands over CDP, including navigation, clicks, text entry, and screenshots.
Which browsers can cdpilot use?
It requires Brave Browser, Google Chrome, or Chromium. Each session uses a separate browser profile.
