tmux-mcp-tools

tmux-mcp-tools

3.2

If you are the rightful owner of tmux-mcp-tools and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

tmux-mcp-tools provides MCP tools for interacting with tmux sessions.

tmux-mcp-tools

Provide MCP tools for interacting with tmux sessions.

Configuration

  • Custom XDG: $XDG_CONFIG_HOME/tmux-mcp-tools/
  • mcp.json: MCP server configuration following Cursor format
  • prompt.md: System prompt template for the AI agent

Tmux Configuration

Add the following to your .tmux.conf file to create a keybinding that opens the client in a new pane:

bind-key M-k split-window -h -p 33 "uvx --from tmux-mcp-tools tmux-agent --target \"$(tmux display-message -t ! -p '#{pane_id}')\" ;"

This will bind Alt+K to open a new pane with the client, targeting the current pane.

Features

Tmux Tools

  • tmux_capture_pane: Capture the content of a tmux pane
  • tmux_send_command: Send commands to a tmux pane with automatic Enter key
  • tmux_send_keys: Send keys to a tmux pane without automatic Enter
  • tmux_write_file: Write content to a file using heredoc pattern in a tmux pane

Usage

{
  "mcpServers": {
    "tmux-mcp-tools": {
      "command": "uvx",
      "args": ["tmux-mcp-tools"]
    }
  }
}