MCP Server

io.github.k8ika0s/mcp-tmux MCP Server

Name: io.github.k8ika0s/mcp-tmux MCP Server
Author: io.github.k8ika0s

io.github.k8ika0s/mcp-tmux

Repository Registry

What is the io.github.k8ika0s/mcp-tmux MCP server?

Model Context Protocol server that lets LLMs collaboratively drive tmux

How to install io.github.k8ika0s/mcp-tmux

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MCP_TMUX_HOST
Optional default SSH host alias to use when none is provided.
MCP_TMUX_SESSION
Optional default tmux session name to use when none is provided.
TMUX_BIN
Optional path to tmux binary if not on PATH.
MCP_TMUX_TIMEOUT_MS
Timeout in milliseconds for tmux/ssh invocations (default 15000).
MCP_TMUX_LOG_DIR
Override log directory (defaults to ~/.config/mcp-tmux/logs).
MCP_TMUX_HOSTS_FILE
Optional JSON file for per-host tmux PATH/bin overrides.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<YOUR_MCP_TMUX_HOST>",
        "MCP_TMUX_SESSION": "<YOUR_MCP_TMUX_SESSION>",
        "TMUX_BIN": "<YOUR_TMUX_BIN>",
        "MCP_TMUX_TIMEOUT_MS": "<YOUR_MCP_TMUX_TIMEOUT_MS>",
        "MCP_TMUX_LOG_DIR": "<YOUR_MCP_TMUX_LOG_DIR>",
        "MCP_TMUX_HOSTS_FILE": "<YOUR_MCP_TMUX_HOSTS_FILE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<YOUR_MCP_TMUX_HOST>",
        "MCP_TMUX_SESSION": "<YOUR_MCP_TMUX_SESSION>",
        "TMUX_BIN": "<YOUR_TMUX_BIN>",
        "MCP_TMUX_TIMEOUT_MS": "<YOUR_MCP_TMUX_TIMEOUT_MS>",
        "MCP_TMUX_LOG_DIR": "<YOUR_MCP_TMUX_LOG_DIR>",
        "MCP_TMUX_HOSTS_FILE": "<YOUR_MCP_TMUX_HOSTS_FILE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<YOUR_MCP_TMUX_HOST>",
        "MCP_TMUX_SESSION": "<YOUR_MCP_TMUX_SESSION>",
        "TMUX_BIN": "<YOUR_TMUX_BIN>",
        "MCP_TMUX_TIMEOUT_MS": "<YOUR_MCP_TMUX_TIMEOUT_MS>",
        "MCP_TMUX_LOG_DIR": "<YOUR_MCP_TMUX_LOG_DIR>",
        "MCP_TMUX_HOSTS_FILE": "<YOUR_MCP_TMUX_HOSTS_FILE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-tmux": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "<YOUR_MCP_TMUX_HOST>",
        "MCP_TMUX_SESSION": "<YOUR_MCP_TMUX_SESSION>",
        "TMUX_BIN": "<YOUR_TMUX_BIN>",
        "MCP_TMUX_TIMEOUT_MS": "<YOUR_MCP_TMUX_TIMEOUT_MS>",
        "MCP_TMUX_LOG_DIR": "<YOUR_MCP_TMUX_LOG_DIR>",
        "MCP_TMUX_HOSTS_FILE": "<YOUR_MCP_TMUX_HOSTS_FILE>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-tmux --env MCP_TMUX_HOST=<YOUR_MCP_TMUX_HOST> --env MCP_TMUX_SESSION=<YOUR_MCP_TMUX_SESSION> --env TMUX_BIN=<YOUR_TMUX_BIN> --env MCP_TMUX_TIMEOUT_MS=<YOUR_MCP_TMUX_TIMEOUT_MS> --env MCP_TMUX_LOG_DIR=<YOUR_MCP_TMUX_LOG_DIR> --env MCP_TMUX_HOSTS_FILE=<YOUR_MCP_TMUX_HOSTS_FILE> -- npx -y @k8ika0s/mcp-tmux