Provides tools for driving local tmux: listing, creating, renaming, and killing sessions; managing windows and panes; sending keys to panes; capturing visible pane output; and retrieving session details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@termmux create a new tmux session called work and list its windows"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Drive local tmux from the command line or as a stdio MCP server. List, create, rename and kill sessions; manage windows and panes; send keys to a pane and capture its visible output.
Every operation runs the real tmux binary with an argument array
(execFile, never a shell string) behind an injectable executor, so
session names and key text are never reinterpreted as shell syntax.
Name a session that does not exist and you get tmux's own error
back. When no tmux server is running, list calls return empty
lists — the same empty world tmux reports.
npx -y @reneturcios/termmux mcpRequires a tmux binary on the host (the container image bundles
none, so containerised runs report tmux unavailable).
Related MCP server: Tmux MCP Server
termmux mcp
termmux list-sessions
termmux create-session <name> [window] [start-dir]
termmux kill-session <name>
termmux list-windows <session>
termmux capture <session> [pane]
termmux send <session> <keys...>
termmux --versionExit codes: 0 success, 1 tmux error, 2 usage error.
Tool | Purpose |
| List all tmux sessions |
| Create a new tmux session |
| Kill a tmux session by name |
| List the windows of a tmux session |
| Create a new window in a tmux session |
| Kill a window in a tmux session |
| List the panes of a tmux session, optionally of one window |
| Send keys (a command line or key names) to a tmux pane |
| Capture the visible contents of a tmux pane as text |
| Rename a tmux session |
| Select (activate) a window in a tmux session |
| Get details of one tmux session |
MCP client config:
{
"mcpServers": {
"termmux": {
"command": "npx",
"args": ["-y", "@reneturcios/termmux", "mcp"]
}
}
}docker run -i ghcr.io/cloudcorprecords/termmux # MCP server (tmux unavailable in-image)
docker run --rm ghcr.io/cloudcorprecords/termmux --versionnpm install
npm run build
npm testMIT license.
This server cannot be deployed
Securely control computers you explicitly pair through files, terminals, processes, screenshots, desktop UI/input, clipboard, browser automation, diagnostics, and document tools.
Remote shell and detached long-running jobs on your own machines — no SSH, open ports or VPN.
Develop, manage, and debug Railway projects, services, and deployments from within agents.
Secure tunneling, reverse proxy and remote access for local applications.
