Verified

Tmux MCP Server

Terminal session management for Claude Desktop enabling control of panes and windows.

Data last scanned 2 days ago · Reviewed 2 months ago

9 4 dangerous tools13 tools★ 301JavaScriptMIT

Overview

This MCP server provides a bridge between Claude Desktop and your tmux environment. It allows AI models to list, navigate, and interact with active sessions, windows, and panes directly from the terminal.

Our verdict

This server carries a high-risk score of 34/100, primarily due to lack of an editorial review, unspecified authentication methods, and unreviewed read-only mode support. Users should exercise caution because the 'execute-command' tool allows the AI to run arbitrary commands within your tmux sessions. It is recommended for advanced users who understand these security implications and are comfortable managing their own risks in a terminal environment.

Supports active management of tmux sessions, windows, and panes
Small footprint with only three direct dependencies
Provides real documentation within the repository

High security risk due to lack of audit and external reviews
Last commit occurred over five months ago
No official vendor maintenance or established security oversight

Setup

Claude Desktop

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

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
list-sessions	List all active tmux sessions	low
find-session	Find a tmux session by name	low
list-windows	List windows in a tmux session	low
list-panes	List panes in a tmux window	low
capture-pane	Capture content from a tmux pane	low
create-session	Create a new tmux session	medium
create-window	Create a new window in a tmux session	medium
split-pane	Split a tmux pane horizontally or vertically with optional size	medium
kill-session	Kill a tmux session by ID	high
kill-window	Kill a tmux window by ID	high