Tmux MCP

🚀 Tmux MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with and view the contents of your tmux sessions. This integration allows the AI assistant to read from, control, and observe your terminal sessions.

🚀 Quick Start

Prerequisites

• Node.js
• tmux installed and running

Configuration in Claude Desktop

Add this MCP server to your Claude Desktop configuration:

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

MCP Server Options

You can specify the type of command-line shell to use (if not specified, the default is bash):

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

When a command needs to be executed, the MCP server needs to know the type of shell being used to correctly read its exit status.

✨ Features

• List and search tmux sessions
• View and navigate tmux windows and panes
• Capture and expose the terminal contents of any pane
• Execute commands in tmux panes and get the results (use with caution ⚠️)
• Create new tmux sessions and windows

Watch the following short video for inspiration!

📚 Documentation

Available Resources

• tmux://sessions - List all tmux sessions
• tmux://pane/{paneId} - View the contents of a specific tmux pane
• tmux://command/{commandId}/result - The result of an executed command

Available Tools

• list-sessions - List all active tmux sessions
• find-session - Find a tmux session by name
• list-windows - List the tmux windows in a session
• list-panes - List the tmux panes in a window
• capture-pane - Capture the contents of a tmux pane
• create-session - Create a new tmux session
• create-window - Create a new window in a tmux session
• execute-command - Execute a command in a tmux pane
• get-command-result - Get the result of an executed command