@audibleblink/tmux-mcp-server
An MCP (Model Context Protocol) server for managing local tmux sessions. Enables AI assistants to interact with tmux for terminal multiplexing, session management, and command execution.
Installation
npm install -g @audibleblink/tmux-mcp-server
Or run directly with npx:
npx @audibleblink/tmux-mcp-server
Requirements
- Node.js >= 18
- tmux installed and available in PATH
Usage
With Claude Desktop
Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "@audibleblink/tmux-mcp-server"]
}
}
}
With OpenCode
Add to your OpenCode config (~/.config/opencode/config.json):
{
"mcp": {
"servers": {
"tmux": {
"type": "local",
"command": ["npx", "-y", "@audibleblink/tmux-mcp-server"]
}
}
}
}
Standalone
tmux-mcp-server
Available Tools
Session Management
tmux_list_sessions- List all active tmux sessionstmux_create_session- Create a new tmux sessiontmux_kill_session- Kill a tmux sessiontmux_rename_session- Rename an existing session
Window Management
tmux_list_windows- List windows in a sessiontmux_create_window- Create a new windowtmux_kill_window- Kill a windowtmux_select_window- Switch to a windowtmux_rename_window- Rename a window
Pane Management
tmux_list_panes- List panes in a windowtmux_split_window- Split window into panestmux_kill_pane- Kill a panetmux_select_pane- Switch to a panetmux_resize_pane- Resize a pane
Interaction
tmux_send_keys- Send keys/commands to a panetmux_capture_pane- Capture pane content/output
License
WTFPL