Tmux-mcp Server

MCP server that gives AI assistants full visibility into your tmux sessions — browse sessions, windows, and panes, read terminal output, and send commands.

Local serverstdio

What is the Tmux-mcp Server?

tmux-mcp is an MCP project maintained in the fr1sk/tmux-mcp repository. The maintainer describes its purpose as “MCP server that gives AI assistants full visibility into your tmux sessions — browse sessions, windows, and panes, read terminal output, and send commands”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using tmux-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
sessionstring
targetstring
linesnumber
keysstring
enterboolean
capture_linesnumber
wait_msnumber
cwdstring
directionhorizontal \
sizenumber
new_namestring
list_sessions
list_windows
list_panes
capture_pane
send_keys
new_session
new_window
split_pane
kill_session
kill_window
kill_pane
rename_session
rename_window

How to install the Tmux-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.