Content
# 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:
```bash
cd /home/ryan/devel/ryan-tmux
pip install -e .
```
2. Add to your Claude desktop app's `claude_desktop_config.json`:
```json
{
"mcpServers": {
"ryan-tmux": {
"command": "ryan-tmux-mcp"
}
}
}
```
**Note:** If you installed in a virtual environment, use the full path to the executable:
```json
{
"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"
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
git
A Model Context Protocol server for Git automation and interaction.