Advertise
MCP.so
Sign In

Tmux MCP Server

@nickgnd

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

nickgnd

Submitted by

Nicolò Gnudi

About Tmux MCP Server

A MCP server for our beloved terminal multiplexer tmux.

#tmux#mcp#mcp-server

Tmux MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "tmux": {
      "command": "npx",
      "args": [
        "-y",
        "tmux-mcp"
      ]
    }
  }
}

Tmux MCP Server tools

13

List all active tmux sessions

Find a tmux session by name

List windows in a tmux session

List panes in a tmux window

Capture content from a tmux pane with configurable lines count and optional color preservation

Create a new tmux session

Create a new window in a tmux session

Kill a tmux session by ID

Kill a tmux window by ID

Kill a tmux pane by ID

Split a tmux pane horizontally or vertically

Execute a command in a tmux pane and get results. For interactive applications (REPLs, editors), use `rawMode=true`. IMPORTANT: When `rawMode=false` (default), avoid heredoc syntax (cat << EOF) and other multi-line constructs as they conflict with command wrapping. For file writing, prefer: printf 'content\n' > file, echo statements, or write to temp files instead

Get the result of an executed command

Overview

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

Frequently asked questions

1

What prerequisites does Tmux MCP Server require?

Node.js and a running tmux installation are required.

2

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

3

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.

4

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.

5

Does Tmux MCP Server support authentication or transports?

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

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Advertise