tabby-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tabby-mcp list all open tabs in Tabby"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tabby-mcp
A lightweight MCP (Model Context Protocol) server that enables control of the Tabby terminal via Chrome DevTools Protocol (CDP).
Features
list_targets - List CDP targets (tabs) with index, title, url, ws_url
execute_js - Execute JavaScript code in Tabby's Electron context
query - Query DOM elements by CSS selector (auto-waits for Angular)
screenshot - Capture Tabby window screenshot
Related MCP server: MCP Browser Logger
About this project
This MCP server was built to automate development and testing of TabbySpaces.
TabbySpaces was written 100% by Claude Code - Igor didn't look at the Angular code once. But for this Python project, he has MCP experience and actually reviewed the code.
Here's the fun part: Claude Code (running inside TabbySpaces) served as the tester for this project. The AI that built the plugin now uses this MCP server to test it. Full circle.
Requirements
Python 3.10+
uv package manager
Tabby terminal with CDP debugging enabled
Installation
From PyPI (recommended)
pip install tabby-mcpOr with uv:
uv pip install tabby-mcpFrom source
git clone https://github.com/halilc4/tabby-mcp.git
cd tabby-mcp
uv syncSetup
1. Launch Tabby with CDP debugging
tabby.exe --remote-debugging-port=92222. Configure Claude Code
Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"tabby": {
"command": "uv",
"args": ["--directory", "/path/to/tabby-mcp", "run", "tabby-mcp"]
}
}
}Usage
Once configured, Claude Code can interact with Tabby through MCP tools:
# Execute JavaScript
execute_js({ "code": "document.title" })
# Query DOM elements
query({ "selector": ".tab-bar button" })Architecture
server.py -> tools.py -> cdp.py -> Tabby (CDP port 9222)Module | Purpose |
| MCP server entry point with stdio transport |
| MCP tool definitions and handlers |
| CDP connection management via pychrome |
License
MIT
Available Tools
4 toolsexecute_jsA
Execute JavaScript code in Tabby terminal context and return the result. Code is wrapped in async IIFE by default for fresh scope and await support.
Inputs: target (required), code (required), wrap.
list_targetsA
List available CDP targets (tabs) with their index, URL, and WebSocket URL
Inputs: no named parameters.
queryA
Query DOM elements by CSS selector. Automatically waits for Angular and element to exist.
Inputs: target (required), selector (required), include_children, include_text, +1 more.
screenshotB
Capture screenshot of Tabby terminal window or specific element
Inputs: target (required), selector, format, quality, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: execute_js runs code, list_targets lists tabs, query finds DOM elements, screenshot captures images. There is no overlap.
Most tools follow a verb_noun pattern (execute_js, list_targets), but 'query' and 'screenshot' are less consistent. Still, the pattern is understandable.
Four tools is appropriate for a focused automation toolkit. Each tool serves a clear function without being excessive or insufficient.
The set covers basic inspection and execution but lacks common browser actions like navigation, clicking, or typing, which limits its completeness for typical automation tasks.
Maintenance
Related MCP Connectors
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
MCP server to assist with JxBrowser development.
Unofficial Browserless MCP — wraps the Browserless headless-Chromium REST API (browserless.io)
A remote MCP server to convert HTML documents (URL or raw source) to PDF or screenshots
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides tools for interacting with Chrome through its DevTools Protocol, enabling remote control of Chrome tabs to execute JavaScript, capture screenshots, monitor network traffic, and more.69 npm52MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that captures browser console logs and network requests via the Chrome DevTools Protocol. It allows users to monitor real-time logs, inspect network traffic, and execute JavaScript code directly in the browser context.1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that connects to your browser to capture screenshots, inspect console logs, network requests, and more via Chrome DevTools Protocol.2-
- AlicenseNot gradedqualityDmaintenanceA lightweight MCP server that enables AI assistants to control Chrome DevTools via CDP for debugging tasks like navigation, screenshots, and JavaScript execution.MIT