Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add charlotte -- npx -y @ticktockbent/charlotte
Open on GitHub

What 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 find instead 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 find and 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/charlotte

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open