@audibleblink/tmux-mcp-server

An MCP (Model Context Protocol) server for managing local tmux sessions. Enables AI assistants to interact with tmux for terminal multiplexing, session management, and command execution.

Installation

npm install -g @audibleblink/tmux-mcp-server

Or run directly with npx:

npx @audibleblink/tmux-mcp-server

Requirements

Node.js >= 18
tmux installed and available in PATH

Usage

With Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tmux": {
      "command": "npx",
      "args": ["-y", "@audibleblink/tmux-mcp-server"]
    }
  }
}

With OpenCode

Add to your OpenCode config (~/.config/opencode/config.json):

{
  "mcp": {
    "servers": {
      "tmux": {
        "type": "local",
        "command": ["npx", "-y", "@audibleblink/tmux-mcp-server"]
      }
    }
  }
}

Standalone

tmux-mcp-server

Available Tools

Session Management

tmux_list_sessions - List all active tmux sessions
tmux_create_session - Create a new tmux session
tmux_kill_session - Kill a tmux session
tmux_rename_session - Rename an existing session

Window Management

tmux_list_windows - List windows in a session
tmux_create_window - Create a new window
tmux_kill_window - Kill a window
tmux_select_window - Switch to a window
tmux_rename_window - Rename a window

Pane Management

tmux_list_panes - List panes in a window
tmux_split_window - Split window into panes
tmux_kill_pane - Kill a pane
tmux_select_pane - Switch to a pane
tmux_resize_pane - Resize a pane

Interaction

tmux_send_keys - Send keys/commands to a pane
tmux_capture_pane - Capture pane content/output

License

WTFPL

tmux-mcp-server