home / mcp / tmux mcp server

tmux MCP Server

Provides a local MCP server to manage tmux sessions, windows, and panes via AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "audibleblink-tmux-mcp-server": {
      "command": "tmux-mcp-server",
      "args": []
    }
  }
}

You run a local MCP server to let AI assistants interact with your terminal multiplexer, enabling you to manage tmux sessions, windows, and panes programmatically. This server exposes a set of actions you can call to list, create, modify, and control your tmux environment from an automation client.

How to use

You can connect to the tmux MCP server from your MCP client using the local stdio endpoint. The server exposes actions for session, window, and pane management, as well as commands to interact with running panes. Typical workflows include listing sessions to find or verify your workspace, creating a new session for a project, splitting windows into panes for parallel tasks, and sending commands to specific panes to automate your workflow.

Operational patterns you’ll use often: - Start a tmux session for a project, then create windows and panes to organize your work. - Rename sessions, windows, or panes to keep your layout clear. - Send commands to a pane to automate builds, tests, or live demonstrations. - Capture or extract pane output for logging or analysis.

How to install

# Prerequisites
node --version             # Node.js >= 18
tmux --version             # tmux installed and in PATH

# Install the MCP server globally
npm install -g @audibleblink/tmux-mcp-server

# Or run directly with npx
npx @audibleblink/tmux-mcp-server

# Standalone usage (standalone executable in PATH after install)
tmux-mcp-server

Additional content

Configure clients to discover and connect to the tmux MCP server using the provided examples for Claude Desktop and OpenCode. These snippets show how to register the local server so your AI assistant can reach it without manually wiring endpoints.

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

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

Available tools

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 tmux session

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

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

tmux_send_keys

Send keys/commands to a pane

tmux_capture_pane

Capture pane content/output