← Tmux MCP Server

Tmux MCP Server 0.2.2

npm · tmux-mcp · current release

13
Tools
1
Resources
2
Templates
0
Prompts

Observation

Observed 2026-08-15T23:18:14.974Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.

Server capabilities
{
  "resources": {
    "subscribe": true,
    "listChanged": true
  },
  "tools": {
    "listChanged": true
  },
  "logging": {}
}

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

Resource templates 2

Prompts 0

Let’s talk about MCP security.

Share your details and our security team will contact you.