English Français العربية

io.github.k8ika0s/mcp-tmux

Official registry Productivity

Model Context Protocol server that lets LLMs collaboratively drive tmux

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @k8ika0s/mcp-tmux
Claude Code 
claude mcp add mcp-tmux -e 'MCP_TMUX_HOST=<MCP_TMUX_HOST>' -e 'MCP_TMUX_SESSION=<MCP_TMUX_SESSION>' -e 'TMUX_BIN=<TMUX_BIN>' -e 'MCP_TMUX_TIMEOUT_MS=<MCP_TMUX_TIMEOUT_MS>' -e 'MCP_TMUX_LOG_DIR=<MCP_TMUX_LOG_DIR>' -e 'MCP_TMUX_HOSTS_FILE=<MCP_TMUX_HOSTS_FILE>' -- npx -y @k8ika0s/mcp-tmux@0.1.7
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-tmux": {
            "command": "npx",
            "args": [
                "-y",
                "@k8ika0s/mcp-tmux@0.1.7"
            ],
            "env": {
                "MCP_TMUX_HOST": "<MCP_TMUX_HOST>",
                "MCP_TMUX_SESSION": "<MCP_TMUX_SESSION>",
                "TMUX_BIN": "<TMUX_BIN>",
                "MCP_TMUX_TIMEOUT_MS": "<MCP_TMUX_TIMEOUT_MS>",
                "MCP_TMUX_LOG_DIR": "<MCP_TMUX_LOG_DIR>",
                "MCP_TMUX_HOSTS_FILE": "<MCP_TMUX_HOSTS_FILE>"
            }
        }
    }
}

Environment variables

  • 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.

Frequently asked questions

What is io.github.k8ika0s/mcp-tmux?

Model Context Protocol server that lets LLMs collaboratively drive tmux

How do I install io.github.k8ika0s/mcp-tmux?

It runs on your machine. In Claude Code: claude mcp add mcp-tmux -e 'MCP_TMUX_HOST=<MCP_TMUX_HOST>' -e 'MCP_TMUX_SESSION=<MCP_TMUX_SESSION>' -e 'TMUX_BIN=<TMUX_BIN>' -e 'MCP_TMUX_TIMEOUT_MS=<MCP_TMUX_TIMEOUT_MS>' -e 'MCP_TMUX_LOG_DIR=<MCP_TMUX_LOG_DIR>' -e 'MCP_TMUX_HOSTS_FILE=<MCP_TMUX_HOSTS_FILE>' -- npx -y @k8ika0s/mcp-tmux@0.1.7. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.k8ika0s/mcp-tmux need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.k8ika0s/mcp-tmux open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.k8ika0s/mcp-tmux?

It is published by k8ika0s. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.