Back to search
tmux-mcp
MCP serverGitHub
A MCP server for our beloved terminal multiplexer tmux.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/nickgnd--tmux-mcp)HTML
<a href="/listings/nickgnd--tmux-mcp"><img src="/api/listings/nickgnd--tmux-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 77 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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!
- </br>
- [](https://www.youtube.com/watch?v=3W0pqRF1RS0)
- ## Prerequisites
- - Node.js
- - tmux installed and running
- ## Usage
- ### Configure Claude Desktop
- Add this MCP server to your Claude Desktop configuration:
- ```json
- "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`
- ```json
- "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 sessions
- - `tmux://pane/{paneId}` - View content of a specific tmux pane
- - `tmux://command/{commandId}/result` - Results from executed commands
- ## Available Tools
- - `list-sessions` - List all active tmux sessions
- - `find-session` - Find a tmux session by name
- - `list-windows` - List windows in a tmux session
- - `list-panes` - List panes in a tmux window
- - `capture-pane` - Capture content from a tmux pane
- - `create-session` - Create a new tmux session
- - `create-window` - Create a new window in a tmux session
- - `split-pane` - Split a tmux pane horizontally or vertically with optional size
- - `kill-session` - Kill a tmux session by ID
- - `kill-window` - Kill a tmux window by ID
- - `kill-pane` - Kill a tmux pane by ID
- - `execute-command` - Execute a command in a tmux pane
- - `get-command-result` - Get the result of an executed command
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.