tmux-mcp
Gives Claude full programmatic access to your tmux sessions through standard stdio transport. You get 15 tools covering the full lifecycle: list sessions/windows/panes, capture up to 5,000 lines of scrollback from any pane, send shell commands or raw key sequences like Ctrl-C, and manage session layout with splits and renames. The standout feature is TMUX_MCP_ALWAYS_USE mode, which routes every shell command the agent runs through a named tmux session instead of direct bash execution, so you watch everything happen live in your terminal. Useful when you want full visibility into what an autonomous agent is doing on your machine, or when you need Claude to interact with long-running processes, read compiler output, or recover from stuck commands. Security warning applies: captured pane output can leak credentials.
- GitHub stars
- 1
- tools
- 13
- transport
- STDIO
- last updated
- Apr 17, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
list_sessionsLists all active tmux sessions. No parameters.
Lists all active tmux sessions. No parameters.
No parameter schema in public metadata yet.
list_windowsLists windows inside a session.
Lists windows inside a session.
No parameter schema in public metadata yet.
list_panesLists panes inside a session or window.
Lists panes inside a session or window.
No parameter schema in public metadata yet.
capture_paneCaptures the current terminal output of a pane.
Captures the current terminal output of a pane.
No parameter schema in public metadata yet.
send_keysSends a command or key sequence to a pane and captures the result.
Sends a command or key sequence to a pane and captures the result.
No parameter schema in public metadata yet.
new_sessionCreates a new detached tmux session.
Creates a new detached tmux session.
No parameter schema in public metadata yet.
new_windowCreates a new window inside an existing session.
Creates a new window inside an existing session.
No parameter schema in public metadata yet.
split_paneSplits a pane into two.
Splits a pane into two.
No parameter schema in public metadata yet.
kill_sessionKills a session and all its windows and panes. Destructive — cannot be undone.
Kills a session and all its windows and panes. Destructive — cannot be undone.
No parameter schema in public metadata yet.
kill_windowKills a window and all its panes. Destructive.
Kills a window and all its panes. Destructive.
No parameter schema in public metadata yet.
kill_paneKills a single pane and its running process. Destructive.
Kills a single pane and its running process. Destructive.
No parameter schema in public metadata yet.
rename_session
No parameter schema in public metadata yet.
rename_window
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
tmux-mcp
tmux-mcp logo
MCP server that gives AI assistants full visibility into your tmux sessions — browse sessions, windows, and panes, read terminal output, and send commands.
Watch your AI agent work in real-time. Enable TMUX_MCP_ALWAYS_USE to force every shell command through a named tmux session instead of direct Bash — every command your AI runs appears live in your terminal, fully auditable.
Works with Claude Code, OpenCode, Cursor, Windsurf, and any MCP-compatible host.
What it can do
Read your terminal state
- List every active tmux session with window count, creation time, and attached status
- List windows inside a session — index, name, pane count, which one is active
- List panes inside a window — size, running command, which one is active
See what's on screen
- Capture the visible output of any pane — up to 5 000 lines of scrollback
- Read logs, compiler errors, server output, test runs — anything in your terminal
Details
- Repository
- github.com/fr1sk/tmux-mcp
- Package
@fr1sk/tmux-mcp- Transport
- STDIO
- Registry
- MCP registry, active