Tmux MCP Server logo

Tmux MCP Server

by nickgnd

The Tmux MCP Server enables Claude Desktop to interact with and view tmux session content. This integration allows AI assistants to read from, control, and observe your terminal sessions.

View on GitHub

Last updated: N/A

What is Tmux MCP Server?

The Tmux MCP Server is a Model Context Protocol server that allows Claude Desktop to interact with and control tmux sessions. It provides an interface for AI assistants to read from, control, and observe terminal sessions.

How to use Tmux MCP Server?

To use the server, add it to your Claude Desktop configuration with the provided JSON snippet, specifying the command and arguments. Optionally, you can specify the shell type. The server then exposes resources and tools accessible through the MCP protocol.

Key features of Tmux MCP Server

  • List and search tmux sessions

  • View and navigate tmux windows and panes

  • Capture and expose terminal content from any pane

  • Execute commands in tmux panes and retrieve results

  • Create new tmux sessions and windows

Use cases of Tmux MCP Server

  • Allowing AI assistants to monitor terminal activity

  • Enabling AI to execute commands in tmux sessions

  • Providing AI with context from terminal output

  • Automating tasks within tmux sessions using AI

FAQ from Tmux MCP Server

What are the prerequisites for using this server?

You need Node.js and tmux installed and running.

How do I configure Claude Desktop to use this server?

Add the provided JSON snippet to your Claude Desktop configuration, specifying the command and arguments for the server.

Can I specify the shell type used by the server?

Yes, you can optionally specify the shell type using the --shell-type argument.

What resources are available through the MCP server?

Available resources include listing sessions, viewing pane content, and retrieving command results.

What tools are available for interacting with tmux?

Available tools include listing sessions/windows/panes, capturing pane content, creating sessions/windows, executing commands, and getting command results.