Tmux MCP Server

An MCP server that lets AI agents interact with terminal sessions through tmux.

Running the Server

go run ./cmd/tmux-mcp-server

The server communicates via stdio and provides tools for managing tmux sessions.

Usage

The server provides these tools:

• start_session - Create a new tmux session
• send_commands - Send commands and keystrokes to a session
• view_session - Capture the current screen content
• list_sessions - Show all active sessions
• join_session - Join an existing session
• close_session - End a session

Example: Editing a file with vim

{
  "name": "start_session",
  "arguments": {
    "session_name": "edit_work",
    "command": "vim README.md"
  }
}

{
  "name": "send_commands",
  "arguments": {
    "session_name": "edit_work",
    "commands": [
      "i",
      "Hello world!",
      "<ESC>",
      ":wq",
      "<ENTER>"
    ]
  }
}

The send_commands tool takes an array where plain strings are typed literally and <COMMAND> format handles special keys like <ENTER>, <ESC>, <TAB>, etc.

Development

This project uses Hermit for managing development dependencies. Hermit ensures consistent development environments across different machines.

. bin/activate-hermit

Requirements

• Go 1.24.2+
• tmux