tmux-mcp-tools
About
tmux-mcp-tools is a Model Context Protocol (MCP) server that provides tools for interacting with tmux sessions. It allows AI assistants to capture pane content, send commands, and write files to tmux panes.
Details
- Author
- PsychArch
- Downloads
- 388
- Categories
- Other
Jump to
- tmux_capture_pane: Capture the content of a tmux pane.
- tmux_send_command: Send commands to a tmux pane with automatic Enter.
- tmux_write_file: Write content to a file using heredoc in a tmux pane.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
tmux-mcp-toolsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server in your MCP client with the command uvx and argument tmux-mcp-tools. Once running, the tools tmux_capture_pane, tmux_send_command, and tmux_write_file become available for use.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"tmux-mcp-tools": {
"tmux-mcp-tools": {
"command": "uvx",
"args": [
"tmux-mcp-tools"
]
}
}
}
}
McpServers
{
"tmux-mcp-tools": {
"command": "uvx",
"args": [
"tmux-mcp-tools"
]
}
}
tmux-mcp-tools
A Model Context Protocol (MCP) server that provides tools for interacting with tmux sessions.
Installation
Features
- tmux_capture_pane: Capture the content of a tmux pane
- tmux_send_command: Send commands to a tmux pane with automatic Enter key
- tmux_write_file: Write content to a file using heredoc pattern in a tmux pane
Usage
{
"mcpServers": {
"tmux-mcp-tools": {
"command": "uvx",
"args": ["tmux-mcp-tools"]
}
}
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



