Tools
Browse the operations the server exposes to MCP clients. Use the registered name and arguments when sending a tools/call request.
The reference configuration advertises 54 tools. Your server’s available objects depend on its configuration. Setup documentation explains how to connect a client.
Server5 tools#
Create a new tmux session.
Get information about the tmux server.
Kill the tmux server and all its sessions.
Discover live tmux servers under the current user’s $TMUX_TMPDIR.
List tmux sessions (terminal workspaces) on a tmux server.
Session5 tools#
Create a new window in a tmux session.
Return metadata for a single tmux session (ID, name, window count, activity).
Kill a tmux session.
List tmux windows (terminal tabs) in a session, or across the server.
Rename a tmux session.
Window9 tools#
Return metadata for a single tmux window (ID, name, layout, dimensions).
Kill (close) a tmux window. Requires exact window_id (e.g. ‘@3’).
List tmux panes (terminal multiplexer splits) in a window, session, or server.
Move a window to a different index or session.
Rename a tmux window.
Resize a tmux window.
Set the layout of a tmux window.
Select (focus) a tmux window by ID, index, or direction.
Split a tmux window to create a new pane.
Pane18 tools#
Capture the visible contents of a tmux pane (terminal scrollback).
Capture new tmux terminal scrollback since the previous cursor.
Clear the contents of a tmux pane.
Find the pane occupying a corner of a tmux window.
Get detailed information about a tmux pane.
Kill (close) a tmux pane. Requires exact pane_id (e.g. ‘%5’).
Paste multi-line text into a pane using tmux paste buffers.
Log a pane’s live output to a file (or stop an active log).
Resize a tmux pane.
Restart a pane’s process in place, preserving pane_id and layout.
Run a shell command in a pane, wait for completion, and capture output.
Search visible terminal text across all tmux panes.
Select (focus) a tmux pane by ID or direction.
Send keys (commands or text) to a tmux pane.
Send an ordered batch of raw key/text operations to tmux panes.
Set the title of a tmux pane.
Snapshot a tmux pane: visible terminal output, cursor, mode, scroll.
Swap the positions of two panes.
Buffers4 tools#
Delete an MCP-owned buffer.
Load text into a new agent-namespaced tmux paste buffer.
Paste an MCP-owned buffer into a pane.
Read back the contents of an MCP-owned buffer.
Hooks2 tools#
Look up a specific tmux hook by name.
List configured tmux hooks at the given scope.
Options and environment4 tools#
Set a tmux environment variable.
Set a tmux option value.
Show tmux environment variables.
Show a tmux option value.
Coordination2 tools#
Signal a tmux wait-for channel, waking blocked waiters.
Block until a tmux wait-for channel is signalled.
Other tools5 tools#
Call several inspect tools serially and return per-tool results.
Read tmux variables against a target and return the substituted text.
Enter copy mode in a tmux pane, optionally scrolling up.
Exit copy mode in a tmux pane.
Wait for NEW output in a tmux pane, then return.
Resources
This server does not advertise resources in the reference configuration.
Resource templates
6 advertised in the reference configuration.
Prompts
4 advertised in the reference configuration.
Reference configuration
LIBTMUX_TOOLSETSinspect,manage,execute,teardown
Protocol version: 2025-11-25. Download the full protocol catalog.
Source: tmux-python/libtmux-mcp@4daddc0dfca9.
The language API reference documents embedding and implementation types.