libtmux-mcp

Name: libtmux-mcp
Availability: InStock
Author: tmux-python

Supports UI

by tmux-python

Give your AI agent hands inside the terminal to manage tmux sessions, windows, and panes.

0 stars

0 views

Works in:CodexGemini CLICursor

Exposes:Tools

View on GitHub Docs

What it does

libtmux-mcp is an MCP server that allows AI agents to orchestrate tmux environments. It enables assistants to create sessions, run shell commands, read real-time pane output, and manage complex terminal layouts without manual copy-pasting.

Tools

create_session: Starts a new tmux session.
send_keys: Sends characters or commands to a specific pane.
capture_pane: Reads the current visible content of a pane.
split_window: Divides a window into multiple panes for side-by-side execution.
list_sessions: Lists all active tmux sessions.
wait_for_text: Pauses until specific output appears in a pane.

Installation

Install and run via uvx:

uvx libtmux-mcp

For Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "tmux": {
      "command": "uvx",
      "args": ["libtmux-mcp"]
    }
  }
}

Supported hosts

Confirmed support for Claude, Codex, Gemini-CLI, and Cursor.

Quick install

uvx libtmux-mcp

Information

Pricing: free
Published: 4/28/2026
stars

Related Apps

Choose your AI client and follow the steps below.

Codex

Add 'tmux' to AGENTS.md or mcp config using 'uvx libtmux-mcp'

Cursor

Add to MCP settings: { "mcpServers": { "tmux": { "command": "uvx", "args": ["libtmux-mcp"] } } }

Gemini CLI

Add to settings.json: { "mcpServers": { "tmux": { "command": "uvx", "args": ["libtmux-mcp"] } } }

Claude Desktop

{ "mcpServers": { "tmux": { "command": "uvx", "args": ["libtmux-mcp"] } } }