DOMShell — Claude Code MCP server: browser access and setup
DOMShell lets an AI agent inspect Chrome pages through filesystem-style commands. Use it to browse page content and extract data through a browser session.
claude mcp add domshell -- npx -y @apireno/domshellWhat DOMShell does
DOMShell represents Chrome’s accessibility tree as folders and files. An agent can inspect pages with commands such as ls, cd, grep, and find, then interact with browser elements using click or type. Several commands can run in one domshell_execute call.
The DOMShell Chrome Extension is required to connect the server to Chrome. Run npx @apireno/domshell init to configure a client and create a token, then start a session from Chrome’s side panel and enter connect <token> in the DOMShell terminal. The server requires Node 18+.
The default setup exposes one tool. Starting the server with --granular also provides separate command tools, which lets the client request approval for individual operations. Write actions require --allow-write; whoami requires --allow-sensitive.
What it helps with
- locate text or elements on a page
- inspect page structure with filesystem-style commands
- extract links or a table from a website
- click a browser element or enter text
- run several browser steps in one tool call
Example prompts for the agent
- Find documentation links on the open page and list them.
- Open the site and extract its pricing table.
- Click the sign-in button and enter my email address.
How to install DOMShell
Platform CLI
claude mcp add domshell -- npx -y @apireno/domshellPlatform CLI
codex mcp add mcp-server -- npx -y @apireno/domshellConfig file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@apireno/domshell"
]
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@apireno/domshell"
]
}
}
}Platform CLI
gemini mcp add mcp-server npx -y @apireno/domshellStep 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 DOMShell
How do I install DOMShell in Claude Code?
Run claude mcp add domshell -- npx -y @apireno/domshell. Install the DOMShell Chrome Extension as well; it connects the server to the browser.
What does DOMShell do?
It maps Chrome’s accessibility tree to a virtual filesystem, letting an agent inspect page content and interact with browser elements through commands.
What does DOMShell need to run?
It requires Node 18+ and the DOMShell Chrome Extension. After starting a browser session, connect with connect <token>.
