tmux-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tmux_list_sessionsA | List all tmux sessions with their names, IDs, window count, and status. |
| tmux_list_windowsA | List all tmux windows. Optionally filter by session name or ID. Args: session: Session name or ID to filter by. If omitted, lists windows from all sessions. |
| tmux_send_keysA | Send keys or commands to a tmux pane. Args: target: Tmux target (e.g. "session:window.pane", "session:window", "session"). keys: Keys to send. Use special key names like "Enter", "C-c", "Escape", "Tab", "Space", etc. literal: If true, send keys literally (the -l flag) without special key lookup. |
| tmux_read_paneA | Read/capture content from a tmux pane. Args: target: Tmux target (e.g. "session:window.pane"). line_count: Number of lines to capture. If omitted, captures entire visible pane. start_line: Start line for history capture (negative = lines before visible area, e.g. -100). |
| tmux_create_sessionA | Create a new tmux session. Args: name: Name for the new session. command: Optional command to run in the initial window. window_name: Optional name for the first window. |
| tmux_create_windowA | Create a new window in an existing tmux session. Args: session: Target session name or ID. name: Optional name for the new window. command: Optional command to run in the new window. |
| tmux_rename_sessionA | Rename a tmux session. Args: old_name: Current session name or ID. new_name: New name for the session. |
| tmux_rename_windowA | Rename a tmux window. Args: target: Tmux target for the window (e.g. "session:window"). new_name: New name for the window. |
| tmux_select_windowA | Navigate/switch to a specific tmux window. Args: target: Tmux target (e.g. "session:window"). |
| tmux_list_panesA | List tmux panes with their IDs, dimensions, and status. Args: target: Session or window target (e.g. "mysession", "mysession:0"). If omitted, lists panes from all sessions. |
| tmux_split_windowA | Split a window/pane to create a new pane. Args: target: Target window or pane to split (e.g. "session:window", "session:window.pane", or "%3"). horizontal: If true, split horizontally (top/bottom). Default is vertical (left/right). size: Size of new pane — percentage (e.g. "50%") or line/column count (e.g. "20"). command: Optional command to run in the new pane. |
| tmux_select_paneA | Select/focus a specific tmux pane. Args: target: Pane target (e.g. "session:window.pane", "%3"). |
| tmux_resize_paneA | Resize a tmux pane. Use direction+amount for relative resize, or width/height for absolute resize. Args: target: Pane target (e.g. "%3", "session:window.pane"). direction: Direction to grow: "up", "down", "left", or "right". amount: Number of cells to resize by (default 5). Used with direction. width: Absolute width in columns. Overrides direction/amount. height: Absolute height in rows. Overrides direction/amount. |
| tmux_killA | Kill a tmux session, window, or pane. Args: target: Tmux target to kill. type: What to kill - "session", "window", or "pane". |
| tmux_read_cc_paneA | Monitor a tmux pane running Claude Code, auto-waiting and auto-approving. Polls the pane in a loop:
Args: target: Tmux target pane (e.g. "session:window.pane", "%3"). timeout: Max seconds to wait before returning (default 1800). poll_interval: Seconds between polls (default 0.5). last_n_lines: Number of trailing non-empty lines to analyze (default 20). |
| remote_bash_connectA | Connect to a remote host via SSH with a persistent shell session. Shell state (working directory, environment variables) persists across subsequent remote_bash_execute calls to the same connection. Args: host: Hostname or IP address. username: SSH username. Defaults to current local username. port: SSH port (default 22). password: SSH password (optional; prefer key-based auth). key_filename: Path to private key file (optional; defaults to SSH agent). connection_id: Optional alias for this connection (default: "user@host:port"). connect_timeout: Timeout in seconds for the connection attempt. |
| remote_bash_executeA | Execute a command on a remote host via an established SSH connection. Shell state (working directory, environment variables, aliases) persists across calls to the same connection_id. Args: command: Shell command to execute. connection_id: Which connection to use. If omitted, uses the most recently active connection. timeout: Max seconds to wait for the command to complete (default 120). |
| remote_bash_disconnectA | Disconnect an SSH connection or all connections. Args: connection_id: Which connection to close. Required if all is false. all: If true, disconnect all active connections. |
| remote_bash_list_connectionsA | List all active SSH connections with their status and idle time. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/WENLIXIAO-CS/tmux-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server