Skip to main content
MCP server CX Codex

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 GitHub

What 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 demo and list its panes.
  • Split the current pane to the right and run go test ./... in the new one.
  • Wait until ready appears in pane %1 and 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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open