Control Chrome browser via 71 MCP tools - screenshots, clicks, forms, downloads, network capture, TTS, history, cookies, emulation. Use when working with browser automation.
TabzChrome provides 71 MCP tools for browser automation via Chrome Extension APIs.
# Always check schema first (MANDATORY)
mcp-cli info tabz/tabz_screenshot
# Then call the tool
mcp-cli call tabz/tabz_screenshot '{}'
| Category | Tools | Purpose |
|---|---|---|
| Tab Management | tabz_list_tabs, tabz_switch_tab, tabz_rename_tab |
Navigate tabs, accurate active detection |
| Tab Groups | tabz_list_groups, tabz_create_group, tabz_update_group, tabz_add_to_group, tabz_ungroup_tabs |
Organize tabs into groups |
| Claude Group | tabz_claude_group_add, tabz_claude_group_remove, tabz_claude_group_status |
Highlight tabs Claude is working with |
| Windows | tabz_list_windows, tabz_create_window, tabz_update_window, tabz_close_window |
Manage browser windows |
| Displays | tabz_get_displays, tabz_tile_windows, tabz_popout_terminal |
Multi-monitor layouts, tiling |
| Screenshots | tabz_screenshot, tabz_screenshot_full |
Capture viewport or full page |
| Interaction | tabz_click, tabz_fill, tabz_get_element, tabz_execute_script |
Click, fill forms, run JS |
| Downloads | tabz_download_image, tabz_download_file, tabz_get_downloads, tabz_cancel_download, tabz_save_page |
Download files, save pages |
| Bookmarks | tabz_get_bookmark_tree, tabz_search_bookmarks, tabz_save_bookmark, tabz_create_folder, tabz_move_bookmark, tabz_delete_bookmark |
Organize bookmarks |
| Network | tabz_enable_network_capture, tabz_get_network_requests, tabz_clear_network_requests |
Monitor API calls |
| Inspection | tabz_get_page_info, tabz_get_console_logs |
Debug, inspect pages |
| Debugger | tabz_get_dom_tree, tabz_profile_performance, tabz_get_coverage |
DOM tree, metrics, coverage |
| Audio/TTS | tabz_speak, tabz_list_voices, tabz_play_audio |
Text-to-speech, audio playback |
| History | tabz_history_search, tabz_history_visits, tabz_history_recent, tabz_history_delete_url, tabz_history_delete_range |
Search and manage history |
| Sessions | tabz_sessions_recently_closed, tabz_sessions_restore, tabz_sessions_devices |
Recover tabs, synced devices |
| Cookies | tabz_cookies_get, tabz_cookies_list, tabz_cookies_set, tabz_cookies_delete, tabz_cookies_audit |
Debug auth, audit trackers |
| Emulation | tabz_emulate_device, tabz_emulate_clear, tabz_emulate_geolocation, tabz_emulate_network, tabz_emulate_media, tabz_emulate_vision |
Responsive testing, accessibility |
| Notifications | tabz_notification_show, tabz_notification_update, tabz_notification_clear, tabz_notification_list |
Desktop alerts with progress |
Interaction tools show visual feedback when targeting elements:
| Tool | Glow Color |
|---|---|
tabz_click |
Green (action completed) |
tabz_fill |
Blue (input focused) |
tabz_get_element |
Purple (inspecting) |
Elements pulse twice and auto-scroll into view.
Right-click any element on a webpage "Send Element to Chat" to capture:
:nth-of-type() for siblings)data-testid, aria-label, role)mcp-cli info tabz/tabz_screenshot
mcp-cli call tabz/tabz_screenshot '{}' # Viewport
mcp-cli call tabz/tabz_screenshot_full '{}' # Full scrollable page
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]"}'
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"}'
mcp-cli call tabz/tabz_create_group '{"title": "Research", "color": "blue"}'
mcp-cli call tabz/tabz_add_to_group '{"groupId": 123, "tabIds": [456, 789]}'
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"}'
mcp-cli call tabz/tabz_download_image '{"selector": "img.hero-image"}'
mcp-cli call tabz/tabz_download_image '{"url": "https://example.com/image.png"}'
Chrome tab IDs are large integers (e.g., 1762561083), NOT sequential like 1, 2, 3.
mcp-cli call tabz/tabz_list_tabs '{}'
Returns:
{
"claudeCurrentTabId": 1762561083,
"tabs": [
{"tabId": 1762561065, "url": "...", "active": false},
{"tabId": 1762561083, "url": "...", "active": true}
]
}
# 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}'
When multiple Claude workers use tabz tools simultaneously, they MUST isolate tabs.
# 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 | Don't |
|---|---|
| Create own tab group at start | Use shared "Claude" group |
| Store your tabIds after opening | Rely on active: true tab |
| Target tabs by explicit ID | Assume current tab is yours |
| Clean up group when done | Leave orphaned tabs/groups |
Add to .mcp.json:
{
"mcpServers": {
"tabz": {
"command": "/path/to/TabzChrome/tabz-mcp-server/run-auto.sh",
"args": [],
"env": { "BACKEND_URL": "http://localhost:8129" }
}
}
}
tabz_screenshot cannot capture Chrome sidebar (Chrome limitation)mcp-cli info tabz/<tool> before mcp-cli callFor detailed information:
references/mcp-tools.md - Complete tool referencereferences/audio-tts.md - TTS voices, settings, APIreferences/api-endpoints.md - REST API referencereferences/debugging.md - Troubleshooting guide| Resource | Purpose |
|---|---|
tabz-expert agent |
Spawn for complex browser work (user-scope plugin) |
tabz-artist skill |
Generate images (DALL-E) and videos (Sora) - now in TabzChrome |
