mcp-tmux

Model Context Protocol server that lets LLMs collaboratively drive tmux

stdio v0.1.7

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.k8ika0s--mcp-tmux -- npx

Transport

stdio

Authentication

None

Version

v0.1.7

Server Name

io.github.k8ika0s/mcp-tmux

Last Updated

Dec 13, 2025

How to install and connect this MCP server.

Environment variables you must provide when running this server.

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