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.

Tools
6
Resources
0
Prompts
0

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