MCP server intelligence profile

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

Local Onlynickgnd
Awaiting current scanNpm · 0.2.2

The selected current version does not yet have completed public verification. Unknown does not mean clean or vulnerable.

1Distribution channel
13Independently observed tools
0Linked remote endpoints
AvailableVersion intelligence

Detailed security scan evidence is not public for this MCP yet. Public identity, registry metadata, and independently observed protocol inventory remain available.

Install and connect

Installation and connection instructions are shown only when supported by retained package, repository, or endpoint evidence.

Install tmux-mcp from npm

Version 0.2.2 declares 1 executable entrypoint.

npm install --save-exact tmux-mcp@0.2.2
npx -y -p tmux-mcp@0.2.2 tmux-mcp
MCP client configuration example
{
  "mcpServers": {
    "tmux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "tmux-mcp@0.2.2",
        "tmux-mcp"
      ]
    }
  }
}

Identity

Canonical slugtmux-mcp-server-48ac8401DeploymentLocal Only
Canonical packagenpm:tmux-mcpRepositorynickgnd/tmux-mcp
First published—Latest release—
Last security verification—Classification confidence90%
PublicationDraftOfficial distributionNot verified

Distributions

ChannelIdentifierCurrent versionVersionsSource
npmtmux-mcp0.2.28Repository

Current release

PackageVersionPublished / observedInventorySecurity scan
npmtmux-mcp0.2.2CurrentSep 5, 202613 toolsSucceeded · 1 resources · 0 promptsEvidence restricted
Enterprise protection

Continuously monitor this MCP for security risk

Independently scan the exact version your agents use, receive alerts when its risk changes, and investigate every finding with retained version evidence.

  • Independent exact-version security scans
  • Continuous release and vulnerability monitoring
  • Risk-change alerts with capability context
  • Historical evidence and API exports
Custom pricingContact salesTailored to your organization, integrations, data needs, and support requirements.

Current version evidence

No public current-version evidence is available yet.

Current protocol inventory

2025-06-18Negotiated protocol
tmux-mcpServer-reported name
3Capability groups
Aug 15, 2026Observed

Tools 13

ToolCategoryAnnotationsRisk
capture-paneCapture content from a tmux pane with configurable lines count and optional color preservation
Input schema
{
  "type": "object",
  "properties": {
    "paneId": {
      "type": "string",
      "description": "ID of the tmux pane"
    },
    "lines": {
      "type": "string",
      "description": "Number of lines to capture"
    },
    "colors": {
      "type": "boolean",
      "description": "Include color/escape sequences for text and background attributes in output"
    }
  },
  "required": [
    "paneId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
create-sessionCreate a new tmux session
Input schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the new tmux session"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
create-windowCreate a new window in a tmux session
Input schema
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "ID of the tmux session"
    },
    "name": {
      "type": "string",
      "description": "Name for the new window"
    }
  },
  "required": [
    "sessionId",
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
execute-commandExecute 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
Input schema
{
  "type": "object",
  "properties": {
    "paneId": {
      "type": "string",
      "description": "ID of the tmux pane"
    },
    "command": {
      "type": "string",
      "description": "Command to execute"
    },
    "rawMode": {
      "type": "boolean",
      "description": "Execute command without wrapper markers for REPL/interactive compatibility. Disables get-command-result status tracking. Use capture-pane after execution to verify command outcome."
    },
    "noEnter": {
      "type": "boolean",
      "description": "Send keystrokes without pressing Enter. For TUI navigation in apps like btop, vim, less. Supports special keys (Up, Down, Escape, Tab, etc.) and strings (sent char-by-char for proper filtering). Automatically applies rawMode. Use capture-pane after to see results."
    }
  },
  "required": [
    "paneId",
    "command"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
find-sessionFind a tmux session by name
Input schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the tmux session to find"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
get-command-resultGet the result of an executed command
Input schema
{
  "type": "object",
  "properties": {
    "commandId": {
      "type": "string",
      "description": "ID of the executed command"
    }
  },
  "required": [
    "commandId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
kill-paneKill a tmux pane by ID
Input schema
{
  "type": "object",
  "properties": {
    "paneId": {
      "type": "string",
      "description": "ID of the tmux pane to kill"
    }
  },
  "required": [
    "paneId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
kill-sessionKill a tmux session by ID
Input schema
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "ID of the tmux session to kill"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
kill-windowKill a tmux window by ID
Input schema
{
  "type": "object",
  "properties": {
    "windowId": {
      "type": "string",
      "description": "ID of the tmux window to kill"
    }
  },
  "required": [
    "windowId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
list-panesList panes in a tmux window
Input schema
{
  "type": "object",
  "properties": {
    "windowId": {
      "type": "string",
      "description": "ID of the tmux window"
    }
  },
  "required": [
    "windowId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
list-sessionsList all active tmux sessions
Input schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}
——
list-windowsList windows in a tmux session
Input schema
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "ID of the tmux session"
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——
split-paneSplit a tmux pane horizontally or vertically
Input schema
{
  "type": "object",
  "properties": {
    "paneId": {
      "type": "string",
      "description": "ID of the tmux pane to split"
    },
    "direction": {
      "type": "string",
      "enum": [
        "horizontal",
        "vertical"
      ],
      "description": "Split direction: 'horizontal' (side by side) or 'vertical' (top/bottom). Default is 'vertical'"
    },
    "size": {
      "type": "number",
      "minimum": 1,
      "maximum": 99,
      "description": "Size of the new pane as percentage (1-99). Default is 50%"
    }
  },
  "required": [
    "paneId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
——

Resources 1

  • Tmux Sessionstmux://sessions

Resource templates 2

  • Command Execution Resulttmux://command/{commandId}/result
  • Tmux Pane Contenttmux://pane/{paneId}

Prompts 0

  • None observed.

Remote endpoints

EndpointTransportAuthenticationHealthObserved
No verified remote endpoint is linked.

Tmux MCP Server questions

How do I install Tmux MCP Server?

Install the selected package version with: npm install --save-exact tmux-mcp@0.2.2

What tools does Tmux MCP Server provide?

Tmux MCP Server exposed 13 tools during independent protocol observation, including capture-pane, create-session, create-window, execute-command, find-session, get-command-result, kill-pane, kill-session, and others.

Is Tmux MCP Server secure?

The selected current version does not yet have completed public verification. Unknown does not mean clean or vulnerable.

Explore related MCP server guides

Curated product and capability guides containing this catalog record.

Official vs Community MCP Servers

Let’s talk about MCP security.

Share your details and our security team will contact you.