Gecko MCP - install, status & alternatives [2026]

01 · Install Gecko MCP

Claude Code

claude mcp add frumane-gecko-mcp -- npx -y gecko-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "frumane-gecko-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gecko-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package gecko-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.Frumane is GitHub-verified and matches the repo owner

03 · What Gecko MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all open tabs (title, URL, browserId, active, pinned), open a new tab at a URL, read the active tab's title, URL and browserId, and navigate an existing tab to a URL.

Capability map

Tools grouped from the project's README - what Gecko MCP lets an agent do.

read & search

8 tools - e.g. List all open tabs (title, URL, browserId, active, pinned).; Return the active tab's title, URL and browserId.; Read a tab's content as clean Markdown (or HTML / accessibility tree). Output is capped…

list_tabs · get_active_tab · read_page · find · get_value · get_attribute…

Real

4 tools - e.g. Type into the focused element via genuine OS key events (isTrusted).; Press a real key/combo, e.g. "Enter", "ctrl+a".; Real Ctrl+A + Delete - reliably clears a rich/contenteditable field.

real_type · real_key · real_clear · real_click

Launch

2 tools - e.g. Ensure Floorp is running - launches it if the API isn't reachable (Windows).; Start any Firefox-based browser (Firefox, LibreWolf, Zen…) with Marionette enabled so gecko-mcp can drive it.

launch_floorp · launch

Wait

2 tools - e.g. Wait for an element to attach / become visible / etc.; Wait for network activity to settle.

wait_for_element · wait_for_network_idle

update

2 tools - e.g. Move the real OS cursor to a screen pixel inside Floorp.; Check/uncheck a checkbox or radio.

move_cursor · set_checked

Open

1 tool - e.g. Open a new tab at a URL; returns the new tab's browserId so you can target it.

open_tab

Navigate

1 tool - e.g. Navigate an existing tab to a URL.

navigate_tab

Close

1 tool - e.g. Close a tab.

close_tab

Limitations (from the README)

Learned from driving real apps (incl. Google Flow): - Rich editors: type_text handles plain inputs and contenteditable editors (Slate, ProseMirror, Lexical) - it falls back to dispatching a real text-input event when an element has no .value. Reliably clearing such editors isn't solved yet (no select-all/evaluate). - Submitting React composers: many chat/prompt composers submit on a real Enter keydown, not on a synth

Latest releases

v2.2.0 · 2026-06-15

Two new tools: · run JavaScript in the page and get the result (Marionette). LOCKED by default like OS input - unlock via enable_evaluate or GECKO_MCP_ENABLE_EVALUATE=1. · start any Firefox-based browser…

v2.1.1 · 2026-06-15

First release built and signed on GitHub Actions with npm provenance - the npm page now links to the exact source commit + CI run, so the package is verifiable against this repo. No code changes from v2.1.0. · npx…

v2.1.0 · 2026-06-15

Trust hardening - for anyone (human or AI) right to be cautious · A package that can drive your browser - and optionally your keyboard/mouse - should · be approached carefully. This release makes that caution easy to…

04 · Who maintains Gecko MCP

gecko-mcp is maintained by frumane. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/frumane/gecko-mcp
category: browser automation - ranked #169 of 255 actively-maintained browser automation servers as of 2026-09-18.
registry: io.github.Frumane/gecko-mcp (active, first published 2026-06-16)
packages: npm:gecko-mcp

06 · Gecko MCP FAQ

Is Gecko MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-06-20. We re-verify nightly.

What can Gecko MCP do?

With this server connected, an agent can list all open tabs (title, URL, browserId, active, pinned), open a new tab at a URL, read the active tab's title, URL and browserId, and navigate an existing tab to a URL.

How do I install Gecko MCP?

Run `npx -y gecko-mcp`. You can also paste the ready-made client config above.

Does Gecko MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Gecko MCP

Alternatives to Gecko MCP

Maintained browser automation servers if Gecko MCP isn't the fit.

Pairs well with

Servers that cover what Gecko MCP doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · Deepadb · Gamedev Pl · Cesium MCP Dev · Cesium MCP Runtime · Munin

More TypeScript MCP servers · npm Run MCP Server · Agent Audit · Fundz · Qubic MCP · see all