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"