The Tmux MCP Server enables AI assistants to seamlessly control and interact with tmux terminal sessions through API calls.
Session Management: List, search, create, and kill tmux sessions by name or ID.
Window Management: List windows within sessions, create new windows with custom names, and kill existing windows.
Pane Operations: List panes within windows, capture pane content with configurable line count and optional color preservation, split panes horizontally or vertically with customizable sizes, and kill panes.
Command Execution: Run commands in specific panes and retrieve results, with support for interactive applications using raw mode.
Provides tools for listing, navigating, and interacting with tmux sessions, windows and panes. Enables capturing terminal content, executing commands in panes, and creating new tmux sessions and windows.
Tmux MCP Server
Model Context Protocol server that enables Claude Desktop to interact with and view tmux session content. This integration allows AI assistants to read from, control, and observe your terminal sessions.
Features
- List and search tmux sessions
- View and navigate tmux windows and panes
- Capture and expose terminal content from any pane
- Execute commands in tmux panes and retrieve results (use it at your own risk ⚠️)
- Create new tmux sessions and windows
- Split panes horizontally or vertically with customizable sizes
- Kill tmux sessions, windows, and panes
Check out this short video to get excited!
Prerequisites
- Node.js
- tmux installed and running
Usage
Configure Claude Desktop
Add this MCP server to your Claude Desktop configuration:
MCP server options
You can optionally specify the command line shell you are using, if unspecified it defaults to bash
The MCP server needs to know the shell only when executing commands, to properly read its exit status.
Available Resources
tmux://sessions
- List all tmux sessionstmux://pane/{paneId}
- View content of a specific tmux panetmux://command/{commandId}/result
- Results from executed commands
Available Tools
list-sessions
- List all active tmux sessionsfind-session
- Find a tmux session by namelist-windows
- List windows in a tmux sessionlist-panes
- List panes in a tmux windowcapture-pane
- Capture content from a tmux panecreate-session
- Create a new tmux sessioncreate-window
- Create a new window in a tmux sessionsplit-pane
- Split a tmux pane horizontally or vertically with optional sizekill-session
- Kill a tmux session by IDkill-window
- Kill a tmux window by IDkill-pane
- Kill a tmux pane by IDexecute-command
- Execute a command in a tmux paneget-command-result
- Get the result of an executed command
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Enables Claude Desktop to interact with and view tmux session content, allowing AI assistants to read from, control, and observe terminal sessions.
Related MCP Servers
- AsecurityAlicenseAqualityAllows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.Last updated -2129,5864,395MIT License
- -securityFlicense-qualityA companion desktop app enabling bi-directional interaction between Claude Desktop and visual UI elements, allowing Claude to display, read from, and write to interactive interfaces while processing user events and feedback.Last updated -56
- AsecurityAlicenseAqualityA server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.Last updated -1929,5864MIT License
- -securityFlicense-qualitylets you interact with your meeting data (to list, ask, summarize, extract - virtually anything about your meeting) through Claude’s desktop client across Zoom, Google Meet and MS Teams via tl;dv.Last updated -164