mcpField
T
Tmux MCP Server

Tmux MCP Server

Local
github.com/nickgndDeveloper Tools305Updated 61w ago
Repository

About Tmux MCP Server

Tmux MCP Server is an MCP server that lets Claude Desktop and other clients view and control tmux session content. It is suited to users who want an AI assistant to read or operate their terminal sessions.

Key features

  1. 01List and search tmux sessions
  2. 02View and navigate windows and panes
  3. 03Capture terminal content from any pane
  4. 04Run commands in panes and retrieve results
  5. 05Create, split and kill sessions, windows and panes

Use cases

  1. 01Letting an AI assistant observe running terminal output
  2. 02Executing commands in an existing tmux session and reading results
  3. 03Managing multi-pane development environments from the command line

MCP support

This project is an MCP server that exposes resources such as tmux://sessions and tmux://pane/{paneId}, along with tools like list-sessions, capture-pane and execute-command, to MCP clients.

#tmux#mcp#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tmux": {
      "command": "npx",
      "args": [
        "-y",
        "tmux-mcp"
      ]
    }
  }
}
Run commandnpx -y tmux-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtmux-mcp

Tools

13

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project 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!


youtube video

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

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp", "--shell-type=fish"]
  }
}

The MCP server needs to know the shell only when executing commands, to properly read its exit status.

Available Resources

  • tmux://sessions - List all tmux sessions
  • tmux://pane/{paneId} - View content of a specific tmux pane
  • tmux://command/{commandId}/result - Results from executed commands

Available Tools

  • list-sessions - List all active tmux sessions
  • find-session - Find a tmux session by name
  • list-windows - List windows in a tmux session
  • list-panes - List panes in a tmux window
  • capture-pane - Capture content from a tmux pane
  • create-session - Create a new tmux session
  • create-window - Create a new window in a tmux session
  • split-pane - Split a tmux pane horizontally or vertically with optional size
  • kill-session - Kill a tmux session by ID
  • kill-window - Kill a tmux window by ID
  • kill-pane - Kill a tmux pane by ID
  • execute-command - Execute a command in a tmux pane
  • get-command-result - Get the result of an executed command

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.