tmux-mcp

MCP.Pizza Chef: nickgnd

Aimed squarely at people who live in a terminal. It reads the contents of your tmux sessions, windows, and panes, so an assistant can see what a command printed, and it can create sessions, split panes, close them, and run commands of its own. You need tmux and Node already installed, then two lines pasted into your assistant's settings. Worth knowing first: the project has had no new commits since February 2026, and the author marks command execution as use-at-your-own-risk.

Coding

Other

Use This MCP server To

Read what my long-running build printed in another window Ask why a command failed without copying its output Set up a new session with the panes already split List every terminal session I currently have open Run a command and get the result back in chat

README

Tmux MCP Server

Model Context Protocol server that enables Claude Desktop to interact with and view tmux session content. This integration allows AI assistants to read from, control, and observe your terminal sessions.

Features

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 it at your own risk ⚠️)
Create new tmux sessions and windows
Split panes horizontally or vertically with customizable sizes
Kill tmux sessions, windows, and panes

Check out this short video to get excited!

Prerequisites

Node.js
tmux installed and running

Usage

Configure Claude Desktop

Add this MCP server to your Claude Desktop configuration:

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

MCP server options

You can optionally specify the command line shell you are using, if unspecified it defaults to bash

tmux-mcp FAQ

Is this still being maintained?

It still works, but there have been no new commits since February 2026. The author has not named a replacement, so treat it as finished rather than growing.

Do I need tmux already?

Yes. tmux is a separate terminal tool you install yourself, and this does nothing without it. Node also has to be installed.

Which apps does it work in?

The instructions cover Claude Desktop, and any other MCP app that accepts the same style of configuration will work.

Do I need a key or an account?

No. It works entirely against terminal sessions on your own machine.

Can I use this to check on a script that is still running?

Yes — it can capture whatever a pane is showing right now and hand that back to the assistant.

Is it safe to let it run commands?

The author flags command execution as use-at-your-own-risk. Anything it runs carries your own permissions, so watch what you approve.

How hard is the setup?

Easy if you already use tmux — paste a two-line block into your assistant's settings, and optionally name the shell you use.