TickTockBent/charlotte
View on GitHub ↗Token-efficient browser MCP server — structured web pages for AI agents, not raw accessibility dumps
174 ★21 forksTypeScriptUpdated 24d ago
What you need to know
Token-efficient MCP server for the web that gives agents structured page representations - landmarks, headings and interactive elements - instead of dumping full accessibility trees
Install
npm install -g @ticktockbent/charlotte Or pull the Docker image for the remote mode
Usage
- •Run charlotte with the default browse profile, navigate and find the elements you need
- •For remote, docker run ghcr.io/ticktockbent/charlotte and add it as a connector in claude.ai
Key features
- ✓Structured page representation with three detail levels
- ✓Orientation ~10-140x smaller than a full accessibility-tree snapshot
- ✓43 tools for navigation, observation, interaction, monitoring and dev mode
- ✓Tool profiles cutting definition overhead up to 75%
- ✓Headless Chromium with automatic crash recovery
- ✓Stable element IDs across DOM mutations
- ✓Remote self-hosting mode with episodic URL and token
Best for
Agents that need token-efficient web browsing with low context overhead
Caveats
- ⚠Chromium sandbox on by default - requires opt-out where the kernel sandbox is unavailable
- ⚠Closed shadow DOM is not captured
- ⚠Node.js 20 or later
Platforms: macOS · Linux · Windows · Cloud (remote)Clients: Claude · Claude Desktop · Claude Code · Cursor · Windsurf · VS Code (Copilot) · Cline · Amp
Reviewed 2026-08-11
Topics
- Stars
- 174★
- Forks
- 21
- Language
- TypeScript
- License
- MIT
- Created
- 2026-02-13
- Last push
- 2026-08-11