tmux-mcp

Created By
fr1sk2 months ago
MCP server for tmux — browse sessions, windows and panes, capture terminal output, and send commands. Force your AI agent to run all commands through tmux for full observability. Works with Claude Code, OpenCode, Cursor, Windsurf, Cline, Roo Code, Continue, Codex, and any MCP-compatible AI assistant.
Overview

tmux-mcp

tmux-mcp gives AI assistants full control over your tmux sessions.

Observe your AI agent in real-time

Set TMUX_MCP_ALWAYS_USE=true to force the agent to run every shell command through a named tmux session instead of direct Bash. Watch exactly what your AI is doing, live in your terminal — every command, every output, nothing hidden.

What it can do

  • List sessions, windows, and panes
  • Capture live terminal output from any pane
  • Send commands and key sequences (Ctrl-C, Escape, arrows)
  • Create sessions, windows, and split panes with a working directory and initial command
  • Kill and rename sessions, windows, and panes
  • Auto-routes all shell commands through tmux when configured

Install

npm install -g @fr1sk/tmux-mcp

Configure

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp"
    }
  }
}

With agent observability

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp",
      "env": {
        "TMUX_MCP_ALWAYS_USE": "true",
        "TMUX_MCP_DEFAULT_SESSION": "agent"
      }
    }
  }
}

Works with Claude Code, OpenCode, Cursor, Windsurf, Cline, Roo Code, Continue, Codex, and any MCP-compatible AI assistant.

Server Config

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp"
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
fr1sk
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Gpt Scrambler

2 days ago