Skip to content
MCP server

tmux

MCP server that lets AI clients drive tmux sessions, windows, and panes

Pricing
Open source
Platforms
CLI, Linux, macOS
Version
0.0.1-alpha.5
Listing updated
today

Similar MCP servers

About tmux

tmux is an open-source MCP server for developer tools. It is available on CLI, Linux, macOS and self-hosted.

The README says this Go server gives Model Context Protocol clients control over one tmux server, covering its sessions, windows, panes, and the output those panes produce. Clients are launched as a subprocess over stdin and stdout, and tmux sessions keep running after the client closes.

Tools are grouped into toolsets (inspect, manage, execute, teardown). By default inspect, manage and execute are granted, while teardown must be requested by name. Waiting for text in a pane, running a shell command and reading its exit status, and splitting panes are among the calls the README demonstrates.

It suits developers who want an AI agent to run long-lived work such as dev servers or test runs in a terminal and watch the output. Operators can narrow what a client may do with environment variables, and input to a pane a person is viewing is refused unless explicitly allowed. The README notes that toolsets shape what is offered but every call runs with the user's own authority.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

split_window
Adds a pane and returns its id.
wait_for_text
Returns when a pattern appears in a pane or a stop pattern matches.
run_shell_command
Waits for a command and returns its exit status and output.
capture_since
Returns what a pane wrote since the last look.
snapshot_pane
Returns a pane's metadata and content together.
send_keys
Sends keys to a pane.
paste_text
Pastes text into a pane.
kill_session
Kills a tmux session.

What it does

Session and pane control
Creates, lists, renames, resizes and moves tmux sessions, windows and panes.
Wait for pane output
Blocks until a pattern appears in a pane or a stop pattern matches, with a configurable ceiling.
Shell command execution
Runs a command in a pane and returns its exit status and output.
Toolset-based permissions
Grants tools by toolset or exact name, with exclusions applied after inclusion.
Protection for attended panes
Refuses input to panes a tmux client is viewing unless explicitly allowed.
Socket selection
Targets a named or explicit tmux socket chosen once at server start.

Good for

  • Run a dev server or test suite in a split pane and wait for it to report readiness
  • Let an agent inspect tmux sessions and read pane output without sending input
  • Drive long-running terminal work from an MCP client while keeping sessions alive after it closes
  • Diagnose which tmux socket and binary a client reaches with the doctor command

Pricing

Open source

Open source; no paid plan mentioned in the README.

tmux FAQ

Which tmux version is required?

The README says Go 1.26 or newer and tmux 3.3a or newer, with some tools needing tmux 3.4 or 3.7.

Does closing the client stop tmux sessions?

No. The README says closing the client ends the server, but tmux sessions keep running.

Which toolsets are granted by default?

Without LIBTMUX_TOOLSETS the server grants inspect, manage and execute. The teardown toolset must be requested by name.

Can the server type into a pane I am watching?

Not by default. Input tools refuse a pane a tmux client is viewing unless LIBTMUX_ALLOW_ATTENDED_INPUT=1 is set.

Is tmux free?

Yes. tmux is open source, so you can use and self-host it for free.

What are the best alternatives to tmux?

The closest alternatives to tmux are shell-use, Coding Tools MCP, agent-manager.dev documentation, Unterm and McpMux.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers