ghostlight — Claude Code MCP server: what it does, how to install
Runs local browser automation inside your active Chromium tabs via MCP. Your agent works in full view using your existing logged-in sessions.
claude mcp add ghostlight -- npx -y ghostlightWhat ghostlight does
Ghostlight links coding assistants to your running Chrome, Brave, or Edge instance. Instead of spinning up an isolated blank window without cookies, it groups agent tabs right inside your existing profile. Every click, keystroke, and page transition remains visible.
A native Rust daemon talks to your browser over local IPC alongside a dedicated browser extension. The server registers 23 catalog tools covering tab control, semantic clicks, form submission, screenshots, and file uploads.
macOS is not supported yet, limiting agent setup strictly to Windows and Linux. You also need Chromium 125 or newer and Node.js if you run the npx installer.
What it helps with
- automate tasks inside pages that already require active user login
- monitor web navigation steps directly in a visible browser tab group
- submit complex web forms and handle file uploads through agent tools
- capture page screenshots and inspect DOM content locally
Example prompts for the agent
- Open https://example.com/ in a new Ghostlight tab, summarize the content, and do not submit any forms.
- Navigate to sylin.org/ghostlight/demo/desk and ring the bell.
How to install ghostlight
Platform CLI
claude mcp add ghostlight -- npx -y ghostlightPlatform CLI
codex mcp add ghostlight -- npx -y ghostlightConfig file
{
"mcpServers": {
"ghostlight": {
"command": "npx",
"args": [
"-y",
"ghostlight"
]
}
}
}Config file
{
"servers": {
"ghostlight": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ghostlight"
]
}
}
}Platform CLI
gemini mcp add ghostlight npx -y ghostlightStep 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 ghostlight
How to install ghostlight in Claude Code?
Run claude mcp add ghostlight -- npx -y ghostlight in your terminal, then install the Ghostlight extension in your Chromium browser when prompted.
What does ghostlight do?
It connects your coding agent to your existing browser session using local IPC, executing navigation, input, and scraping tasks inside a visible tab group.
Does ghostlight work on macOS?
No, the agent setup currently supports only Windows and Linux. You also need a Chromium browser such as Chrome, Brave, or Edge at version 125 or higher.
