Installation

Requirements

• Python 3.10+

• tmux >= 3.2a

• uv (install) or pipx (install) — for running without a persistent install

Run without installing

No persistent install needed — run directly with a package executor:

uvx

$ uvx libtmux-mcp

pipx

$ pipx run libtmux-mcp

To wire it into your MCP client, see MCP Clients.

Install the package

uv

$ uv pip install libtmux-mcp

pip

$ pip install libtmux-mcp

Development install

Install uv (install), then clone and install in editable mode:

$ git clone https://github.com/tmux-python/libtmux-mcp.git

$ cd libtmux-mcp

$ uv pip install -e "."

Code changes take effect immediately — no reinstall needed.

Running the server

$ libtmux-mcp

Or via Python module:

$ python -m libtmux_mcp

Upgrading

uv

$ uv pip install --upgrade libtmux-mcp

pip

$ pip install --upgrade libtmux-mcp

With uvx or pipx run, you always get the latest version automatically.