- tmux-mcp
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 AllGpt Scrambler
2 days ago
Mcp Server Chatsum
@chatmcp
summarize chat message
typescript
a year ago
Serper MCP Server
@garymengcom
A Serper MCP Server
Python
a year ago
Playwright Mcp
@microsoft
Playwright MCP server
TypeScript
10 months ago