tmux MCP Server

tmux MCP server enabling AI agents to control tmux terminal multiplexer sessions — creating and managing windows and panes, sending commands to terminal sessions, reading terminal output, and integrating tmux's persistent terminal management into agent-driven shell automation and multi-process orchestration workflows.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Developer Tools tmux terminal mcp-server shell automation terminal-multiplexer
⚙ Agent Friendliness
77
/ 100
Can an agent use this?
🔒 Security
76
/ 100
Is it safe for agents?
⚡ Reliability
68
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
68
Documentation
70
Error Messages
68
Auth Simplicity
98
Rate Limits
92

🔒 Security

TLS Enforcement
80
Auth Strength
72
Scope Granularity
68
Dep. Hygiene
70
Secret Handling
90

Local shell execution. No credentials. Community MCP. Equivalent to shell access — grant carefully.

⚡ Reliability

Uptime/SLA
72
Version Stability
68
Breaking Changes
68
Error Recovery
65
AF Security Reliability

Best When

An agent needs to manage persistent terminal sessions — running long processes, interacting with interactive CLIs, or orchestrating multi-pane development environments via tmux.

Avoid When

You just need to run a single shell command — direct Bash execution is simpler. tmux MCP adds complexity without benefit for simple commands.

Use Cases

  • Running shell commands in persistent tmux sessions from automation agents
  • Managing multiple terminal windows and panes from DevOps agents
  • Reading command output from long-running processes from monitoring agents
  • Orchestrating multi-process workflows from orchestration agents
  • Automating development environment setup from bootstrapping agents
  • Controlling interactive CLI tools that require persistent sessions

Not For

  • Single command execution (use Bash directly for one-off commands)
  • Teams not using tmux for terminal management
  • Production automation (tmux is for interactive terminal sessions)

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: none
OAuth: No Scopes: No

No authentication — communicates with tmux server on local machine via tmux CLI. tmux must be installed and running. OS process permissions apply.

Pricing

Model: free
Free tier: Yes
Requires CC: No

tmux is free open source software. MCP server is free. Local tool only — no external costs.

Agent Metadata

Pagination
none
Idempotent
Partial
Retry Guidance
Not documented

Known Gotchas

  • tmux must be running with an active server — start tmux session before using MCP
  • Session/window/pane naming conventions matter — use consistent naming for reliable targeting
  • Command output capture may be unreliable for rapidly updating terminal output
  • Interactive programs (vim, nano) may not work well through tmux MCP automation
  • Community MCP — tmux-mcp is a niche tool with limited community testing
  • Pane synchronization issues may cause command interleaving in multi-pane scenarios

Alternatives

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for tmux MCP Server.

$99

Scores are editorial opinions as of 2026-03-06.

5220
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered