Tmux MCP Server

List all active tmux sessions.

Returns information about each session including:

• Session name

• Number of windows

• Creation time

• Whether the session is currently attached

Use this tool to discover available sessions before operating on them.

Create a new tmux session.

Args:

• name (string, required): Name for the new session

• window_name (string, optional): Name for the initial window

• start_directory (string, optional): Starting directory for the session

The session is created in detached mode. Use this to start new working environments.

Kill (terminate) a tmux session and all its windows/panes.

Args:

• name (string, required): Name of the session to kill

WARNING: This will terminate all processes running in the session.

List all windows in a tmux session.

Args:

• session (string, required): Name of the session

Returns information about each window including index, name, active status, and pane count.

Create a new window in a tmux session.

Args:

• session (string, required): Name of the session

• name (string, optional): Name for the new window

• start_directory (string, optional): Starting directory for the window

Kill (close) a window in a tmux session.

Args:

• session (string, required): Name of the session

• window (string or number, required): Window index or name

WARNING: This will terminate all processes running in the window.

List all panes in a tmux window.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name (defaults to current/active window)

Returns information about each pane including index, dimensions, and current command.

Split a window into panes.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• horizontal (boolean, optional): Split horizontally (default: false = vertical split)

• start_directory (string, optional): Starting directory for the new pane

• percentage (number, optional): Size of new pane as percentage (1-99)

Kill (close) a pane in a tmux window.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• pane (number, required): Pane index

WARNING: This will terminate the process running in the pane.

Send keys or commands to a tmux pane.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• pane (number, optional): Pane index

• keys (string, required): Keys or command to send

• enter (boolean, optional): Press Enter after sending keys (default: true)

Examples:

• Send a command: keys="ls -la", enter=true

• Send text without executing: keys="echo hello", enter=false

• Send special keys: keys="C-c" (Ctrl+C), keys="C-d" (Ctrl+D)

Capture the visible content or history of a tmux pane.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• pane (number, optional): Pane index

• start_line (number, optional): Start line (negative = history, 0 = top of visible)

• end_line (number, optional): End line (use - for bottom of visible pane)

• escape_sequences (boolean, optional): Include escape sequences (default: false)

This tool is useful for reading command output or checking the state of a pane.

Switch to a specific window in a tmux session.

Args:

• session (string, required): Name of the session

• window (string or number, required): Window index or name

Switch to a specific pane in a tmux window.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• pane (number, required): Pane index

Rename an existing tmux session.

Args:

• old_name (string, required): Current session name

• new_name (string, required): New session name

Rename a window in a tmux session.

Args:

• session (string, required): Name of the session

• window (string or number, required): Window index or current name

• new_name (string, required): New window name

Resize a pane in a tmux window.

Args:

• session (string, required): Name of the session

• window (string or number, optional): Window index or name

• pane (number, optional): Pane index

• direction (string, required): Direction to resize: up, down, left, right

• amount (number, optional): Number of cells to resize by (default: 5)