Server: tmux

Overview

tmux MCP server lets the agent control tmux sessions/windows/panes for long-running workflows.

SSoT: unified-mcp-system/configs/servers/core.yaml (tmux)

Install / run

• Command: pnpm
• Args: ["dlx","-y","@hughescr/tmux-mcp-server@3.0.2","--shell-type=zsh"]

Requirements

• tmux installed on the host running the server
• Proper permissions to create sessions / send keys

Usage patterns

• Use tmux windows as “workspaces” per task (build, logs, deploy).
• Prefer non-blocking execution; capture output via tools rather than waiting on long commands.

Troubleshooting

• “no server running”: start tmux or ensure the MCP server can create its own session.
• Scrollback too small: increase tmux history limit or use server settings (if supported).