Connect a Rust MCP client

Edit this page on GitHub

tmux-mcp 0.1.0-alpha.13 · Source

Install the tmux-mcp executable, then let your MCP client launch it. Rust 1.88 or newer is required to build the crate, and tmux 3.2a or newer must be on the runtime path.

Install and connectLink to section

Cargo requires an explicit prerelease version:

$ cargo install \
    --version 0.1.0-alpha.13 \
    tmux-mcp

Use a named socket and an inspection toolset:

$ LIBTMUX_TOOLSETS=inspect tmux-mcp \
    --socket-name docs-agent

The executable waits for MCP requests. A client using mcpServers can launch the same command:

{
  "mcpServers": {
    "tmux-rust": {
      "command": "tmux-mcp",
      "args": ["--socket-name", "docs-agent"],
      "env": {"LIBTMUX_TOOLSETS": "inspect"}
    }
  }
}

Without a selector, it uses the dedicated libtmux-mcp socket with a minimal configuration. --socket selects an explicit socket path.

Verify the selectionLink to section

Ask the client to list tools and read tmux://capabilities. The inspect toolset includes discovery, capture, and bounded observation. Add execute for command execution and teardown for removal. Client approval uses MCP annotations; the retired safety and confirmation flags fail startup.

Diagnose failuresLink to section

Read stderr for launcher diagnostics; stdout carries MCP. Use tmux-mcp --help for supported arguments. If a target disappeared, re-list it. Inspect partial effects before submitting another change.

Executable contract.