mcp-tmux
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 vars
MCP_TMUX_HOST MCP_TMUX_SESSION TMUX_BIN MCP_TMUX_TIMEOUT_MS MCP_TMUX_LOG_DIR MCP_TMUX_HOSTS_FILEClaude 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
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.