Tabz MCP

TabzChrome MCP Tools

TabzChrome provides 71 MCP tools for browser automation via Chrome Extension APIs.

Quick Start

# Always check schema first (MANDATORY)
mcp-cli info tabz/tabz_screenshot

# Then call the tool
mcp-cli call tabz/tabz_screenshot '{}'

Tool Categories (71 Tools)

Visual Feedback

Interaction tools show visual feedback when targeting elements:

Elements pulse twice and auto-scroll into view.

Getting CSS Selectors

Right-click any element on a webpage "Send Element to Chat" to capture:

• Unique CSS selector (with :nth-of-type() for siblings)
• Tag, ID, classes, text content
• Useful attributes (data-testid, aria-label, role)

Common Workflows

Screenshot a Page

mcp-cli info tabz/tabz_screenshot
mcp-cli call tabz/tabz_screenshot '{}'            # Viewport
mcp-cli call tabz/tabz_screenshot_full '{}'       # Full scrollable page

Fill and Submit Form

mcp-cli call tabz/tabz_fill '{"selector": "#username", "value": "user@example.com"}'
mcp-cli call tabz/tabz_fill '{"selector": "#password", "value": "secret"}'
mcp-cli call tabz/tabz_click '{"selector": "button[type=submit]"}'

Debug API Issues

mcp-cli call tabz/tabz_enable_network_capture '{}'
# Trigger the action
mcp-cli call tabz/tabz_get_network_requests '{}'
mcp-cli call tabz/tabz_get_network_requests '{"filter": "/api/users"}'

Organize Tabs into Groups

mcp-cli call tabz/tabz_create_group '{"title": "Research", "color": "blue"}'
mcp-cli call tabz/tabz_add_to_group '{"groupId": 123, "tabIds": [456, 789]}'

Text-to-Speech

mcp-cli call tabz/tabz_list_voices '{}'
mcp-cli call tabz/tabz_speak '{"text": "Build complete"}'
mcp-cli call tabz/tabz_speak '{"text": "Alert!", "priority": "high"}'

Download Images

mcp-cli call tabz/tabz_download_image '{"selector": "img.hero-image"}'
mcp-cli call tabz/tabz_download_image '{"url": "https://example.com/image.png"}'

Tab Targeting (Critical)

Chrome tab IDs are large integers (e.g., 1762561083), NOT sequential like 1, 2, 3.

Always List Tabs First

mcp-cli call tabz/tabz_list_tabs '{}'

Returns:

{
  "claudeCurrentTabId": 1762561083,
  "tabs": [
    {"tabId": 1762561065, "url": "...", "active": false},
    {"tabId": 1762561083, "url": "...", "active": true}
  ]
}

Use Explicit tabId

# DON'T rely on implicit current tab
mcp-cli call tabz/tabz_screenshot '{}'  # May target wrong tab!

# DO use explicit tabId
mcp-cli call tabz/tabz_screenshot '{"tabId": 1762561083}'

Parallel Worker Isolation

When multiple Claude workers use tabz tools simultaneously, they MUST isolate tabs.

Required Pattern: Own Tab Group

# 1. Create unique group for this worker
SESSION_ID=$(tmux display-message -p '#{session_name}' 2>/dev/null || echo "worker-$$")
mcp-cli call tabz/tabz_create_group "{\"title\": \"$SESSION_ID\", \"color\": \"blue\"}"

# 2. Open tabs IN that group
mcp-cli call tabz/tabz_open_url '{"url": "https://example.com", "groupId": <group_id>}'

# 3. Always use explicit tabIds from YOUR group

Do's and Don'ts

MCP Server Configuration

Add to .mcp.json:

{
  "mcpServers": {
    "tabz": {
      "command": "/path/to/TabzChrome/tabz-mcp-server/run-auto.sh",
      "args": [],
      "env": { "BACKEND_URL": "http://localhost:8129" }
    }
  }
}

Limitations

• tabz_screenshot cannot capture Chrome sidebar (Chrome limitation)
• Always call mcp-cli info tabz/<tool> before mcp-cli call
• Tab IDs are real Chrome tab IDs (large integers)
• Debugger tools (DOM tree, coverage) show Chrome's debug banner

Reference Documentation

For detailed information:

• references/mcp-tools.md - Complete tool reference
• references/audio-tts.md - TTS voices, settings, API
• references/api-endpoints.md - REST API reference
• references/debugging.md - Troubleshooting guide

Related