Mcp Tmux
Let your agent create tmux panes, send commands, and read session output on local or SSH hosts during hands-on dev and deploy tasks.
Overview
io.github.k8ika0s/mcp-tmux is an MCP server for the Build phase that lets LLMs collaboratively drive tmux sessions locally or over SSH.
What is this MCP server?
- MCP tools for collaborative tmux control from LLM clients
- Optional SSH host alias via MCP_TMUX_HOST and default session MCP_TMUX_SESSION
- Configurable tmux binary path TMUX_BIN and 15000 ms default invocation timeout
- Per-host overrides via MCP_TMUX_HOSTS_FILE JSON
- npm package @k8ika0s/mcp-tmux v0.1.7 stdio transport
- Package version 0.1.7
- Default MCP_TMUX_TIMEOUT_MS 15000
- Default log dir ~/.config/mcp-tmux/logs
What problem does it solve?
Agents cannot see or steer long-lived terminal work in tmux, so you manually copy output and rerun commands the model cannot observe.
Who is it for?
Indie devs who already use tmux on laptop or remote hosts and want Claude Code or Cursor to share that session safely with defaults and SSH aliases.
Skip if: Builders who only use integrated terminals with no tmux or SSH workflow, or who cannot accept agent-issued shell commands.
What do I get? / Deliverables
After setup, your agent can attach to named tmux sessions, run commands with timeouts, and use logged invocations for repeatable dev and ops loops.
- Agent-driven tmux pane and session operations
- Configurable timeouts and logging for tmux or ssh calls
- Default host and session env for faster repeated invocations
Recommended MCP Servers
Journey fit
Terminal session control supports Build when agents pair-program on servers, runners, or long-running dev processes. Agent-tooling fits because the server exists so LLMs collaboratively drive tmux, not to replace your IDE alone.
How it compares
tmux session MCP driver, not a cloud hosting panel or generic bash-only one-shot runner.
Common Questions / FAQ
Who is mcp-tmux for?
Developers using tmux who want MCP-enabled agents to send keys, read panes, and coordinate multi-step terminal work.
When should I use mcp-tmux?
Use it during Build or Operate-style debugging when tasks span persistent tmux windows on local machines or SSH hosts.
How do I add mcp-tmux to my agent?
Install @k8ika0s/mcp-tmux from npm, configure MCP_TMUX_HOST, MCP_TMUX_SESSION, TMUX_BIN, and timeout env vars as needed, then register the stdio MCP server in your client.