Tmux MCP Server

MCPOpen Source31.9

by jonrad • Workflow & Task Management

A proof-of-concept server for controlling tmux sessions programmatically using the Model Context Protocol.

Example Use Cases

1
Automate tmux session management.
2
Integrate tmux controls within larger workflows.
3
Experiment with MCP server implementations.

Description

Tmux MCP Server is a demonstration of implementing the Model Context Protocol to allow programmatic control over tmux sessions. It enables users to run arbitrary tmux commands, which can be useful for automating and integrating tmux session controls in various applications. Note that this is a proof-of-concept and should not be used in production environments.

Capabilities(15 total)

Tools (15)

tmux_list_sessions

List all tmux sessions with their names, IDs, window count, and status.

tmux_list_windows

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.

session:any

tmux_send_keys

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.

target:string*keys:string*literal:boolean

tmux_read_pane

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).

target:string*line_count:anystart_line:any

tmux_create_session

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.

name:string*command:anywindow_name:any

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

D41/100

6/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities15 Tools / 0 Prompts / 0 Resources

Ownerjonrad

CategoryWorkflow & Task Management

Dependenciestmuxrequired

Set Your Username