Tmux

Provides programmatic control over tmux sessions via MCP, enabling command execution and pane reading.

other

6

GitHub Stars

other

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jonrad-tmux-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jonrad/tmux-mcp",
        "tmux-mcp"
      ]
    }
  }
}

This MCP Server provides programmatic control over tmux sessions, enabling you to manage panes, run commands, and read pane contents through a standardized MCP client. It’s useful for automating terminal workflows, remote session management, and integrating tmux with other tooling.

How to use

To use this MCP server, configure your MCP client to connect via the stdio runtime described here. You will run the tmux MCP service as a local process and interact with it through the MCP client, issuing commands that are translated into tmux actions.

Basic client configuration example (stdio workflow):

{
  "mcpServers": {
    "tmux": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/jonrad/tmux-mcp", "tmux-mcp"]
    }
  }
}

Typical workflows you can perform

Open a tmux session or attach to an existing one and run commands remotely.
Create, split, resize, or close panes via MCP commands.
Read contents of a pane to feed into logs or processing pipelines.
Automate session setup for dashboards, development environments, or CI tasks.

Available tools

tmux_commands

Execute arbitrary tmux commands and interact with panes, enabling remote session management and pane content retrieval.