Tmux MCP Server

What is Tmux MCP Server?

Tmux MCP Server enables Claude Desktop to interact with and view tmux session content, allowing AI assistants to read from, control, and observe terminal sessions.

How to use Tmux MCP Server?

Add this MCP server to your Claude Desktop configuration by specifying the command and arguments. Optionally set the shell type with --shell-type (defaults to bash). The server provides resources (tmux://...) and tools to list, capture, create, and kill tmux sessions, windows, and panes.

Key features of Tmux MCP Server

• List and search tmux sessions
• View and navigate tmux windows and panes
• Capture and expose terminal content from any pane
• Execute commands in tmux panes and retrieve results (use at own risk)
• Create new tmux sessions, windows, and split panes
• Kill tmux sessions, windows, and panes

Use cases of Tmux MCP Server

• Let an AI assistant read the output of a running terminal process
• Execute commands in a specific pane and inspect their results
• Create new tmux windows or split panes during a session

FAQ from Tmux MCP Server

What prerequisites does Tmux MCP Server require?

Node.js and a running tmux installation are required.

How do I configure the shell type for command execution?

Use the --shell-type flag when starting the server, e.g., --shell-type=fish. Defaults to bash.

What resources and tools does Tmux MCP Server provide?

It provides resources like tmux://sessions and tmux://pane/{paneId}, and tools such as list-sessions, capture-pane, execute-command, create-session, split-pane, and more.

Is there any risk when using Tmux MCP Server?

Executing commands in tmux panes is done at your own risk, as indicated by the warning in the README.

Does Tmux MCP Server support authentication or transports?

The README does not mention any authentication or additional transport options beyond standard MCP.