Tmux MCP Server

Name: Tmux MCP Server
Author: nickgnd

@nickgnd

リポジトリ

Tmux MCP Server について

A MCP server for our beloved terminal multiplexer tmux.

#tmux #mcp #mcp-server

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

nickgnd

投稿者

Nicolò Gnudi

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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

Create a new tmux session

Create a new window in a tmux session

Split a tmux pane horizontally or vertically with optional size

Kill a tmux session by ID

Kill a tmux window by ID

Kill a tmux pane by ID

Execute a command in a tmux pane

Get the result of an executed command

概要

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.