1. Conduid
  2. Developer Tools
  3. Tmux
MCP server · Developer Tools

Tmux

by · github.com/nickgnd/tmux-mcp

A MCP server for our beloved terminal multiplexer tmux.

Unclaimed MIT last commit 8 months ago comms
InstallView source
44Fair

Scored yesterday · breakdown

About Tmux

Tmux is an MCP server published by nickgnd in the Developer Tools category: a MCP server for our beloved terminal multiplexer tmux.

The repository has 306 stars and 57 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add tmux-mcp -- npx -y @fr1sk/tmux-mcp
npx
npx -y @fr1sk/tmux-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (13)

capture-paneCapture content from a tmux pane

Parameters not published.

create-sessionCreate a new tmux session

Parameters not published.

create-windowCreate a new window in a tmux session

Parameters not published.

execute-commandExecute a command in a tmux pane

Parameters not published.

find-sessionFind a tmux session by name

Parameters not published.

get-command-resultGet the result of an executed command

Parameters not published.

kill-paneKill a tmux pane by ID

Parameters not published.

kill-sessionKill a tmux session by ID

Parameters not published.

kill-windowKill a tmux window by ID

Parameters not published.

list-panesList panes in a tmux window

Parameters not published.

Show all 13 tools
list-sessionsList all active tmux sessions

Parameters not published.

list-windowsList windows in a tmux session

Parameters not published.

split-paneSplit a tmux pane horizontally or vertically with optional size

Parameters not published.

Ask AI

✦

Ask AI about Tmux

Powered by Claude · Grounded in docs

I know everything about Tmux. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository yesterday. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

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

README fetched from the repository yesterday. The original is authoritative.

Questions

About Tmux

How do I install Tmux?

Run claude mcp add tmux-mcp -- npx -y @fr1sk/tmux-mcp, then add the server to your MCP client's configuration.

Is Tmux safe to use with an AI agent?

Its trust score is 44 out of 100 (fair). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Tmux still maintained?

The last commit was 8 months ago and 19 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.