charlotte — Claude Code MCP server: web pages without the bloat
charlotte hands your agent a compact, typed page structure instead of a full accessibility tree. Shows its worth when an agent browses often and burns tokens on noise.
MIT ★ 184 updated 2026-10-22
claude mcp add charlotte -- npx -y @ticktockbent/charlotteWhat charlotte does
Charlotte keeps a persistent headless Chromium session and turns each page into a structured view: landmarks, headings, interactive elements, forms, and content summaries. Three detail levels let the agent decide how much it receives.
On arrival, navigate returns a short orientation. For Hacker News that is 364 characters; a full snapshot from Playwright MCP runs around 50,000. When the agent needs more, it calls observe or find and pays only for the part it asked for. On content-heavy pages the orientation is 10–140x smaller than a full snapshot.
It ships 43 tools, but profiles keep startup light: the default browse profile carries about 49% less definition overhead than loading everything, and core cuts it by roughly 75%. The toolset covers navigation, observation, iframe-aware interaction, console and request monitoring, tabs, device emulation, network throttling, dev_serve with auto-reload, and dev_audit for a11y, performance, SEO, contrast, and broken links.
Node.js is required: the server runs through npx.
What it helps with
- cut token spend when an agent reads pages
- get page structure without a full accessibility tree
- locate one element with
findinstead of reading a whole snapshot - take a screenshot and diff the structure against a snapshot
- check a page for a11y, SEO and broken links
Example prompts for the agent
- Open Hacker News and list the first five headlines
- Find the login button with
findand click it - Fill the form on this page with data from
data.json
How to install charlotte
Platform CLI
claude mcp add charlotte -- npx -y @ticktockbent/charlottePlatform CLI
codex mcp add charlotte -- npx -y @ticktockbent/charlotteConfig file
{
"mcpServers": {
"charlotte": {
"command": "npx",
"args": [
"-y",
"@ticktockbent/charlotte"
]
}
}
}Config file
{
"servers": {
"charlotte": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ticktockbent/charlotte"
]
}
}
}Platform CLI
gemini mcp add charlotte npx -y @ticktockbent/charlotteStep 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 charlotte
How do I install charlotte in Claude Code?
Run claude mcp add charlotte -- npx -y @ticktockbent/charlotte.
Why use charlotte instead of Playwright MCP?
Charlotte returns a compact orientation on navigation; Playwright MCP hands over the full accessibility snapshot. On content-heavy pages charlotte's orientation is 10–140x smaller. On tiny pages the difference is marginal.
What does charlotte need to run?
Node.js — the server starts through npx. Chromium runs headless inside the server itself.