tmux — Claude Code MCP server: features and installation
tmux is an MCP server for Claude Code that controls sessions, windows, and panes on one tmux server. An agent can run commands in a pane and wait for matching text.
MIT ★ 5 updated 2026-11-17
Open on GitHubWhat tmux does
The server connects an MCP client to a single tmux server and exposes its sessions, windows, and panes to an agent. The agent can split a pane, send text to it, run a command, then wait for a pattern to appear.
Socket selection happens at startup through flags or environment variables. Toolsets include inspect, manage, and execute, but choosing a toolset does not restrict the process's user permissions. It requires Go 1.26 or newer and tmux 3.3a or newer on PATH.
What it helps with
- manage tmux sessions through an MCP client
- open a separate pane for an agent task
- send a command to a pane and read its output
- wait for a text pattern to appear in a pane
Example prompts for the agent
- Create a tmux session named
demoand list its panes. - Split the current pane to the right and run
go test ./...in the new one. - Wait until
readyappears in pane%1and report the result.
How to install tmux
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tmux
How do I install tmux in Claude Code?
Install the server with go install github.com/libtmux/libtmux-go/mcp/cmd/libtmux-mcp@latest, then register it using claude mcp add tmux -- libtmux-mcp.
What does the tmux MCP server do?
It lets an agent control one tmux server, including its sessions, windows, and panes, and run commands while reading pane output.
What does tmux need to run?
It requires Go 1.26 or newer and tmux 3.3a or newer on PATH.