Mcp Tmux

Lets an assistant drive tmux sessions, including over SSH, to run and inspect terminal commands collaboratively.

What you can do

This local MCP server exposes tmux to an assistant so it can create and manage sessions, panes and windows, and run commands inside them. It can target a local tmux instance or a remote host reached over SSH, and it accepts defaults for the host and session name so calls can omit them. Logs and invocation timeouts are configurable.

When to use it

Use it when an assistant needs to work in persistent terminal sessions, for example to run long-lived processes, watch output across commands, or operate on a remote machine over SSH. It is a desktop-only local process, so it is not suitable for browser or hosted environments.

Requirements

Runs locally over stdio as the npm package @k8ika0s/mcp-tmux, so Node.js and a tmux binary are needed. Optional environment variables: MCP_TMUX_HOST, MCP_TMUX_HOSTS_FILE, MCP_TMUX_LOG_DIR, MCP_TMUX_SESSION, MCP_TMUX_TIMEOUT_MS and TMUX_BIN. Remote use requires working SSH access to the target host.