tmux-mcp
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 agoUpdated At
2 months agoAuthor Name
fr1skStar
-Language
-License
-Recommend Servers
View AllAmap Maps
@amap
高德地图官方 MCP Server
a year ago
Serper MCP Server
@garymengcom
A Serper MCP Server
Python
a year ago
Tavily Mcp
@tavily-ai
JavaScript
a year ago