@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

Or run directly with npx:

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):

With OpenCode

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

Standalone

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