Summary
Tmux Mcp enables Claude Desktop to interact with tmux terminal sessions by providing tools to list, search, and navigate sessions, windows, and panes, as well as capture terminal content and execute commands within panes. The server exposes resources for viewing session data and command results, and includes capabilities for creating new sessions and windows, splitting panes, and managing tmux elements. It solves the problem of giving AI assistants direct visibility into and control over active terminal environments for enhanced context awareness and automation.
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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:
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp"]
}
}
MCP server options
You can optionally specify the command line shell you are using, if unspecified it defaults to bash
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp", "--shell-type=fish"]
}
}
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
Featured
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
