Charlotte MCP Server

by TickTockBent• 184•• Scanned•Claim this listing•Request removal

Browser Automationai agentsmcpmcp servermodel context protocoltypescript

Token-efficient browser MCP server — structured web pages for AI agents, not raw accessibility dumps

Charlotte is an open-source mcp server by TickTockBent, written mainly in TypeScript, with 184 GitHub stars and the MIT license. Its code was last updated Oct 31, 2026. The latest npm release is @ticktockbent/charlotte 0.8.0, published Aug 9, 2026, with 311 downloads last week.

Scan summary: scanned Nov 5, 2026 at commit b944331. Seen able to read environment and secrets, control a web browser, connect to the internet. Scan policy

about README security reviews

How to install Charlotte

Built from the start command in the project's README: npx @ticktockbent/charlotte. Check the README for required keys or settings.

Claude Code · Terminal

claude mcp add charlotte -- npx @ticktockbent/charlotte

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": [
        "@ticktockbent/charlotte"
      ]
    }
  }
}

Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": [
        "@ticktockbent/charlotte"
      ]
    }
  }
}

VS Code · Terminal

code --add-mcp '{"name":"charlotte","command":"npx","args":["@ticktockbent/charlotte"]}'

What Charlotte can touch

Run shell commandsNot seen in this scan
Run dynamic codeNot seen in this scan
Read or write filesNot seen in this scan
Read environment and secretsFound in the code by our scan
Control a web browserListed as a tool: charlotte_navigate
Connect to databasesNot seen in this scan
Read or send messagesNot seen in this scan
Touch money or tradingNot seen in this scan
Connect to the internetFound in the code by our scan

"Not seen" means our checks did not find it, and the tool may still do it. Covers commit b944331, Nov 5, 2026. See the scan policy.

Before you install Charlotte

AgenticMart scanned Charlotte on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What it can access

An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.
Based on its description and topics, it likely needs to control a web browser (visit sites, fill in and submit forms).

Before you install

Run it in a separate browser profile without your logged-in accounts.
Pin the version you reviewed instead of always installing the latest release.
Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.

Maintained by TickTockBent on GitHub, 184 stars and 23 forks. Popularity is not proof of safety.
Last code change: Oct 31, 2026.
Open-source license: MIT.

Read the scan report What our scan checks

Tools Charlotte exposes (23)

Listed by the server itself during our scan of commit b944331.

charlotte_navigate
Load a URL in the active page. Returns page representation after navigation. Default minimal detail includes landmarks, headings, and interactive element counts — use charlotte_find to locate specific elements, or pass detail: 'summary' to get the full element list.
charlotte_back
Navigate back in browser history. Returns page representation after navigation.
charlotte_forward
Navigate forward in browser history. Returns page representation after navigation.
charlotte_reload
Reload the current page. Returns page representation after reload.
charlotte_observe
Get current page state without performing any action. Use detail levels to control verbosity: "minimal" for landmarks, headings, and interactive element counts by landmark (use charlotte_find to get specific elements with actionable IDs, or observe({ detail: "summary" }) to see all elements), "summa
charlotte_find
Search for elements matching criteria. Filters interactive elements by text, role, type, or spatial proximity. Use the selector parameter to find DOM elements by CSS selector — this reaches elements not in the accessibility tree (custom widgets, non-semantic divs). Selector results return Charlotte
charlotte_screenshot
Capture a visual screenshot. Fallback for when structured representation isn't sufficient (complex visualizations, canvas elements, images). Use save: true to persist as a file artifact that can be referenced later.
charlotte_screenshots
List all saved screenshot artifacts. Returns metadata for each saved screenshot including ID, filename, page URL, and timestamp.
charlotte_screenshot_get
Retrieve a previously saved screenshot artifact by its ID. Returns the image data and metadata.
charlotte_screenshot_delete
Delete a saved screenshot artifact by its ID. Removes the file from disk.
charlotte_diff
Compare current page state to a previous snapshot. Returns structural diff showing added, removed, moved, and changed elements.
charlotte_click
Click an interactive element on the page. Returns full page representation after the click.
charlotte_click_at
Click at specific page coordinates. Use when target elements are not in the accessibility tree (custom widgets, canvas, non-semantic interactive divs). Dispatches real CDP-level mouse events. Returns full page representation after the click.
charlotte_type
Type text into an input element. Returns full page representation after typing.
charlotte_select
Select an option in a select/dropdown element. Returns full page representation after selection.
charlotte_toggle
Toggle a checkbox or switch element. Returns full page representation after toggle.
charlotte_submit
Submit a form. Can submit by form ID or by clicking its submit button. Returns full page representation after submission.
charlotte_scroll
Scroll the page or a specific container. Returns full page representation after scrolling.
charlotte_tabs
List all open browser tabs with their URLs, titles, and active status.
charlotte_tab_open
Open a new browser tab. Optionally navigate to a URL. The new tab becomes the active tab.
charlotte_tab_switch
Switch to a different browser tab by its tab ID. Returns the page representation of the activated tab.
charlotte_tab_close
Close a browser tab by its ID. If the closed tab was active, switches to the first remaining tab.
charlotte_tools
Manage Charlotte tool visibility. Lists available tool groups and their status. Use 'enable' or 'disable' to control which tools are loaded. Disabled tools don't appear in the tool list — enable a group to access its tools. Groups: 'interaction' for form filling, clicking, and drag-and-drop. 'sessio

Charlotte is an open-source mcp server by TickTockBent, written mainly in TypeScript. Token-efficient browser MCP server — structured web pages for AI agents, not raw accessibility dumps

At a glance

Stars: 184
Forks: 23
Language: TypeScript
License: MIT
Created: Feb 2026
Last update: Oct 31, 2026
Type: MCP Server
Price: Free

Topics

ai-agentsmcpmcp-servermodel-context-protocoltypescriptweb-browsingweb-scraping

Questions about Charlotte

What is Charlotte?

Token-efficient browser MCP server — structured web pages for AI agents, not raw accessibility dumps

Who maintains Charlotte?

Charlotte is maintained by TickTockBent on GitHub (TickTockBent/charlotte). AgenticMart lists it from public repository data.

Is Charlotte safe to use?

What license does Charlotte use?

It is published under the MIT license.

Guides

Charlotte alternatives

View more →

Similar mcp servers in Browser Automation, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

Name	Stars	Licence	Last updated	Scan
Charlotte (this page) TickTockBent	184	MIT	Oct 31, 2026	Scanned, no flagged issues
Chrome Devtools MCP ChromeDevTools	55k	Apache-2.0	Nov 1, 2026	Scanned, no flagged issues
Playwright MCP microsoft	39k	Apache-2.0	Oct 31, 2026	Scanned, no flagged issues
MCP Chrome hangwin	13k	MIT	Jan 6, 2026	Scanned, no flagged issues
Browser Tools MCP AgentDeskAI	7.3k	MIT	Oct 28, 2026	Scanned, no flagged issues
MCP BrowserMCP	7.3k	Apache-2.0	Oct 30, 2026	Scanned, no flagged issues