Tmux MCP server
io.github.k8ika0s/mcp-tmux·v0.1.7Model Context Protocol server that lets LLMs collaboratively drive tmux
54 downloads/wk
Reviews
Write oneNobody has reviewed Tmux yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Tmux tools (36, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
tmux_apply_layout_profileApply a previously saved layout profile to a session. Windows are matched by index; pane counts must be compatible.
tmux_batch_captureCapture scrollback from multiple panes in parallel (readonly).
tmux_capture_layoutReturn window layouts for a session so they can be restored later.
tmux_capture_paneRead the scrollback of a pane to observe command results.
tmux_commandwrite actionExecute any tmux subcommand with raw args. Use this when helpers do not cover your use case. You are responsible for correctness and safety.
tmux_context_historyCapture recent scrollback from a pane or session to infer context; also extracts recent commands heuristically.
tmux_default_contextReturns the default session (if any) and a quick layout snapshot.
tmux_get_defaultDisplay the current remembered defaults.
tmux_healthCheck tmux availability, PATH/bin resolution, and session listing for a host.
tmux_kill_panewrite actionClose a tmux pane. Use with care.
tmux_kill_sessionwrite actionTerminate a tmux session. Use with care.
tmux_kill_windowwrite actionClose a tmux window. Use with care.
tmux_list_panesList panes across windows or inside a specific target.
tmux_list_sessionsEnumerate sessions with attachment counts and window totals.
tmux_list_windowsList windows within a session (or all sessions if no target provided).
tmux_multi_runwrite actionSend the same keys to multiple targets (across hosts) and optionally capture results.
tmux_new_sessionwrite actionCreate a detached tmux session to collaborate in.
tmux_new_windowwrite actionCreate a window in a target session, useful for side-by-side collaboration.
tmux_open_sessionGiven an ssh host alias and session name, ensure the remote tmux session exists (create if missing) and set it as default for subsequent commands.
tmux_quickstartReturns a concise how-to for using the tmux MCP tools safely.
tmux_readonly_stateReadonly variant of tmux_state to retrieve sessions, windows, panes, and recent capture without modifying defaults.
tmux_rename_sessionRename a tmux session.
tmux_rename_windowRename a tmux window.
tmux_restore_layoutApply a saved layout string to a target window.
tmux_run_batchwrite actionExecute multiple shell commands sequentially in one tmux pane and capture the output. Uses "&&" by default (fail fast) or ";" when failFast=false. Automatically captures output (paged) and can clean the prompt before writing.
tmux_save_layout_profileCapture layouts for all windows in a session and store them under a profile name.
tmux_select_paneSelect a pane so subsequent commands target it.
tmux_select_windowSelect a window so subsequent commands target it.
tmux_send_keyswrite actionSend keystrokes to a tmux target, optionally appending Enter.
tmux_server_infoReturn the running server version and package identifier for verification.
tmux_set_audit_loggingEnable or disable verbose audit logging for a host/session (logs commands and outputs).
tmux_set_defaultPersist defaults for later tool calls. Omit fields you do not want to change.
tmux_set_sync_panesEnable or disable synchronize-panes for a window.
tmux_split_paneSplit a pane horizontally or vertically, optionally running a command.
tmux_stateReturn sessions, windows, panes, and the last lines of the active/default pane.
tmux_tail_panePoll a pane multiple times to watch output without reissuing commands.
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancerepository not readable: repo not found3/15
- Maintainer identityno repository or website to verify2/10
How Tmux compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 65/100
- higher than 15% of 1,299 Productivity servers
- Tools
- 36
- the typical Productivity server has 7
- Tools that change things
- 25%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 54
- more than 42% of 427 Productivity servers with a package
What its tools let an agent do: 27 read · 9 change
Install Tmux in Claude Code, Cursor or VS Code
Runs npx -y @k8ika0s/mcp-tmux on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-tmux -- npx -y @k8ika0s/mcp-tmux
Tmux: common questions
- Is Tmux MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Tmux safety report
- How do I install Tmux?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Tmux need an API key?
- No secret keys are declared. It reads 6 settings from the environment.
- Is Tmux maintained?
- The latest release is v0.1.7.
- What can I use instead of Tmux?
- Servers from other publishers that do the same job: Argent MCP server, gflow-cli MCP server and Buoy Gg MCP server.
- How does Tmux compare with other Productivity MCP servers?
- safety score 65/100 (higher than 15% of 1,299 Productivity servers); tools 36 (the typical Productivity server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Tmux
Same job from other publishers: the closest match first, then the best rated.
- ArgentDrive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agentnot reviewedWidely usedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedEstablishedA
- Buoy GgLet AI agents read and drive a running React Native or Flutter app through Buoy's devtools.not reviewedEstablishedA
- Unreal EngineEngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.not reviewedEstablishedB
- Microsoft Learn MCPOfficial Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.not reviewedEstablishedA