Ryan's Tmux MCP Server

MCP server for tmux operations that provides comprehensive control over tmux sessions, windows, and panes.

Installation

1. Install the package:

cd /home/ryan/devel/ryan-tmux
pip install -e .

2. Add to your Claude desktop app's claude_desktop_config.json:

{
  "mcpServers": {
    "ryan-tmux": {
      "command": "ryan-tmux-mcp"
    }
  }
}

Note: If you installed in a virtual environment, use the full path to the executable:

{
  "mcpServers": {
    "ryan-tmux": {
      "command": "/path/to/your/project/venv/bin/ryan-tmux-mcp"
    }
  }
}

Available Commands

• list-sessions - List all tmux sessions

• find-session - Find sessions by pattern

• list-panes - List panes (optionally filtered by session)

• capture-panes - Capture content from multiple panes

• arrange-panes - Arrange panes with layouts

• list-windows - List windows in a session

• capture-pane - Capture specific pane content

• create-session - Create new sessions

• execute-command - Send commands to panes

• set-prompt - Set custom prompts

• get-command-result - Execute and capture command results

• decorate-pane - Add titles to panes

Usage Examples

After installation, you can use these commands in Claude:

• "List all my tmux sessions"

• "Capture the content from pane kam:0.0"

• "Create a new session called 'work'"

• "Send 'ls -la' to pane kam:0.0"

• "Arrange the panes in session 'kam' with tiled layout"