Allows AI assistants to control the Tabby terminal on Linux, providing tools to execute commands, read terminal buffers, and manage tabs and sessions.
Allows AI assistants to control the Tabby terminal on macOS, providing tools to execute commands, read terminal buffers, and manage tabs and sessions.
Click on "Install 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-MCPlist all my open tabs and tell me what's in the current buffer"
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 Comprehensive MCP Server Plugin for Tabby Terminal
Connect AI assistants to your terminal with full control capabilities β 18 MCP tools included
β¨ Features
π₯οΈ Terminal Control
Execute commands with output capture
Read terminal buffer content
Abort running commands
List all terminal sessions
π Tab Management
Create/Close/Duplicate tabs
Navigate between tabs
Move tabs left/right
Reopen closed tabs
π Profile Management
List all terminal profiles
Open new tabs with profiles
SSH quick connect
Profile selector dialog
π Security Features
Pair programming mode
Command confirmation dialogs
Comprehensive logging
Safe command execution
π¦ Installation
Method 1: Quick Install (Recommended)
No Node.js required! Downloads pre-built release from GitHub.
Or download and run:
Or download and run:
Method 2: Build from Source
Requires Node.js 18+.
Or manually:
π After Installation
Restart Tabby
Go to Settings β MCP
Start the MCP server
π Connecting AI Clients
Cursor / Windsurf
Add to ~/.cursor/mcp.json:
Other Clients
Endpoint | URL |
SSE |
|
Health |
|
Info |
|
π οΈ Available Tools
Terminal Control (4)
Tool | Description |
| List all terminal sessions |
| Execute command with output |
| Read terminal buffer |
| Abort running command |
Tab Management (10)
Tool | Description |
| List all open tabs |
| Focus a specific tab |
| Close a tab |
| Close all tabs |
| Duplicate a tab |
| Navigate tabs |
| Reorder tabs |
| Reopen closed tab |
Profile Management (4)
Tool | Description |
| List terminal profiles |
| Open tab with profile |
| Show profile dialog |
| SSH quick connect |
βοΈ Configuration
Setting | Description | Default |
Port | MCP server port | 3001 |
Start on Boot | Auto-start server | true |
Pair Programming | Confirm commands | true |
β οΈ Platform Support
Platform | Status | Notes |
macOS | β Tested | Fully functional |
Windows | β οΈ Untested | Should work β please report issues |
Linux | β οΈ Untested | Should work β please report issues |
Note: This plugin has been developed and tested on macOS. Windows and Linux support should work but is unverified. Community testing and feedback welcome!
π€ About This Project
π¨ 95%+ AI Generated
This project was created almost entirely by AI (Claude/Gemini) through pair programming.
The human's role was primarily to provide requirements and test the results.
Acknowledgments
This project builds upon the work of tabby-mcp-server by @thuanpham582002.
Improvements over the original:
Feature | Original | This Project |
MCP Tools | 4 | 18 |
Tab Management | β | β |
Profile/SSH | β | β |
Init Bug | Has issue | β Fixed |
Install Script | Manual | β One-liner |
π€ Contributing
See CONTRIBUTING.md for guidelines.
π License
MIT License - see LICENSE
Made with β€οΈ by AI and GentlemanHu
β Star this repo if you find it useful!