@mcpware/chrome-pilot

chrome-pilot

AI-controlled Chrome with real profile sync. Like Playwright, but with your bookmarks, passwords, and extensions.

Why?

Playwright is great for browser automation, but every session starts with a clean browser — no logins, no cookies, no bookmarks. You have to re-authenticate every time.

chrome-pilot solves this by launching your real Chrome with persistent profiles. Sign into Google once, and Chrome Sync brings over all your data. Every subsequent launch retains your sessions.

Playwright:      Clean Chromium → re-login every time
chrome-pilot:    Real Chrome + your profile → sessions persist forever

Install

npm install @mcpware/chrome-pilot

Quick Start

As an MCP Server (for Claude, etc.)

Add to your MCP config:

{
  "mcpServers": {
    "chrome-pilot": {
      "command": "npx",
      "args": ["@mcpware/chrome-pilot"]
    }
  }
}

Then ask your AI:

• "Open my personal Chrome and go to GitHub"
• "Take a screenshot of the current page"
• "List my Chrome profiles"

As a Library

import { launchProfile, listProfiles, closeProfile } from "@mcpware/chrome-pilot";

// Launch Chrome with a persistent profile
const { page, port } = await launchProfile("personal", {
  url: "https://github.com",
});

// First time? Chrome sign-in page appears.
// Sign into Google → Chrome Sync pulls your bookmarks, passwords, extensions.
// Next time? Everything is already there.

await page.screenshot({ path: "screenshot.png" });
await closeProfile("personal");

MCP Tools

Profile Management

Tool	Description
list_profiles	List all Chrome profiles with linked Google accounts
create_profile	Create a new profile
delete_profile	Delete a profile and its data
launch	Launch Chrome with a profile (auto-creates if needed)
close	Close a profile session
get_active	List running sessions with CDP ports

Browser Control

Tool	Description
navigate	Go to a URL
screenshot	Capture the page as PNG
click	Click an element by CSS selector
type	Type text into focused element
fill	Fill a form field by selector
eval	Run JavaScript in page context
snap	Get accessibility tree of the page

Tab Management

Tool	Description
list_tabs	List all open tabs
new_tab	Open a new tab

How It Works

• Uses your real Chrome (not Playwright's bundled Chromium)
• Persistent profiles stored in ~/.chrome-pilot/profiles/
• Chrome Sync brings your bookmarks, passwords, and extensions
• Multi-profile support — run personal and work Chrome simultaneously
• MCP interface — AI agents control Chrome through standard MCP tools
• CDP bridge — each profile gets its own debugging port

Requirements

• Google Chrome installed on your system
• Node.js 20+

License

MIT