tmux-mcp

Overview

This MCP server provides a bridge between AI assistants and the popular terminal multiplexer tmux. It allows Claude Desktop to view terminal content, navigate sessions, and even execute commands within tmux panes. The server exposes both resources for reading pane content and tools for session management, pane manipulation, and command execution.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list-sessions

  List all active tmux sessions

  Try:Show me all my tmux sessionsTry:What tmux sessions are running?
• find-session

  Find a tmux session by name

  Try:Find the session named 'work'Try:Locate my development session
• list-windows

  List windows in a tmux session

  Try:Show me all windows in session 'dev'Try:What windows are open in my main session?
• list-panes

  List panes in a tmux window

  Try:Show all panes in window 1Try:How many panes are in this window?
• capture-pane

  Capture content from a tmux pane

  Try:Show me the content of pane 2Try:What's in the current tmux pane?
• create-session

  Create a new tmux session

  Try:Create a new session called 'project-x'Try:Start a new tmux session
• create-window

  Create a new window in a tmux session

  Try:Add a new window to session 'dev'Try:Create a window named 'api'
• split-pane

  Split a tmux pane horizontally or vertically with optional size

  Try:Split this pane verticallyTry:Create a horizontal split with 80% size
• kill-session

  Kill a tmux session by ID

  Try:Close session 'temp'Try:End session 2
• execute-command

  Execute a command in a tmux pane

  Try:Run 'ls -la' in pane 1Try:Execute 'git status' in current pane
• get-command-result

  Get the result of an executed command

  Try:Show me the result of my last commandTry:What was the output of the previous command?
• kill-pane

  Kill a tmux pane by ID

  Try:Close pane 3Try:Terminate this pane

Comparable tools

Installation

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp"]
  }
}

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp", "--shell-type=fish"]
  }
}

FAQ

Is it safe to execute commands through this MCP server?

The README includes a warning: 'use it at your own risk ⚠️' as executing commands in tmux panes carries inherent security risks.

Which shells are supported?

The server defaults to bash but can be configured to work with other shells like fish by specifying the shell-type option.

Compare tmux-mcp with