← Back to browse

mcp-tmux

Indexed by io.github.k8ika0s

About

Model Context Protocol server that lets LLMs collaboratively drive tmux

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)
Env varsMCP_TMUX_HOST MCP_TMUX_SESSION TMUX_BIN MCP_TMUX_TIMEOUT_MS MCP_TMUX_LOG_DIR MCP_TMUX_HOSTS_FILE
Claude Code
claude mcp add --env MCP_TMUX_HOST= --env MCP_TMUX_SESSION= --env TMUX_BIN= --env MCP_TMUX_TIMEOUT_MS= --env MCP_TMUX_LOG_DIR= --env MCP_TMUX_HOSTS_FILE= mcp-tmux -- npx @k8ika0s/mcp-tmux
Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code
code --add-mcp '{"name":"mcp-tmux","command":"npx","args":["@k8ika0s/mcp-tmux"],"env":{"MCP_TMUX_HOST":"","MCP_TMUX_SESSION":"","TMUX_BIN":"","MCP_TMUX_TIMEOUT_MS":"","MCP_TMUX_LOG_DIR":"","MCP_TMUX_HOSTS_FILE":""}}'
JSON
{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "@k8ika0s/mcp-tmux"
      ],
      "env": {
        "MCP_TMUX_HOST": "",
        "MCP_TMUX_SESSION": "",
        "TMUX_BIN": "",
        "MCP_TMUX_TIMEOUT_MS": "",
        "MCP_TMUX_LOG_DIR": "",
        "MCP_TMUX_HOSTS_FILE": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.