# Weavetab

Weavetab lets AI agents operate Chromium pages and local Electron apps through CDP. It provides structured page maps and tools for interacting with visible interface elements.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: Weavetab
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Weavetab/mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/weavetab

## What it does

Weavetab connects an MCP client to Chromium browsers and Electron desktop software using the Chrome DevTools Protocol. Instead of sending an entire HTML document to the model, `browser_map` builds a semantic representation with stable element references. Later reads can report only changed nodes, keeping the agent's view focused on what has changed.

The server includes pointer controls for navigating nested menus and `browser_type_secret` for resolving credentials on the server side. Its security layer covers domain policies, role-based permissions, and audit records. Communication uses stdio or an optional WebSocket endpoint bound to `127.0.0.1:3000`; the CDP connection stays on `127.0.0.1` as well.

Node.js 18 or newer is required. Start the package with `npx -y @weavetab/mcp`, then register it in the configuration for your MCP client. The target browser or Electron application must be available locally for the agent to control it.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @weavetab/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add weavetab -- npx -y @weavetab/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "weavetab": {
            "command": "npx",
            "args": [
                "-y",
                "@weavetab/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "weavetab": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@weavetab/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add weavetab npx -y @weavetab/mcp
```

## When to use it
- Locate page controls without sending the full HTML to the model
- Navigate nested browser menus and activate their final items
- Operate user interfaces in local Electron applications
- Enter credentials without exposing them in the model context
- Refresh a page map using only the changes since the previous read

## Example prompts
- Open the project page in Chromium and locate the sign-in control using the semantic map.
- Navigate through the “File” → “Export As” → “PNG” menu and activate the final item.
- Use `browser_type_secret` to fill the authentication field without exposing the credential to the model.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md