tmux-mcp-server

lox/tmux-mcp-server

3.3

If you are the rightful owner of tmux-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

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