drio
Open app

Tmux MCP Server

Source

A MCP server for our beloved terminal multiplexer tmux.

Catalog onlyCatalog onlySTDIO

Overview

Tmux MCP is a Model Context Protocol server that allows AI assistants to interact with and view tmux session content, enabling control and observation of terminal sessions.

To use Tmux MCP, clone the repository, install dependencies, and configure it with your Claude Desktop setup to enable interaction with tmux sessions.

  • List and search tmux sessions - View and navigate tmux windows and panes - Capture and expose terminal content from any pane - Execute commands in tmux panes and retrieve results - Create new tmux sessions and windows
  1. Automating terminal tasks with AI assistance
  2. Monitoring and controlling multiple terminal sessions
  3. Integrating terminal commands into AI workflows

Add to your AI client

Use these steps to connect Tmux MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "tmux-mcp-nickgnd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-tmux-mcp-nickgnd"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

What are the prerequisites for Tmux MCP?

You need Node.js, npm or yarn, and tmux installed and running.

How do I install Tmux MCP?

Clone the repository, install dependencies, and build the project using npm.

Can I use Tmux MCP with different shell types?

Yes! You can specify the shell type in the configuration.

Developer tools