T Pane MCP Server

MCP server for tmux pane management and command execution

Local serverstdioTypeScript

What is the T Pane MCP server?

T pane mcp server connects T Pane to AI assistants that speak the Model Context Protocol. MCP server for tmux pane management and command execution.

What T Pane does

An MCP (Model Context Protocol) server that enables Claude to execute commands in tmux panes, providing a shared terminal experience between Claude and users.

Key capabilities

  • Directory-Aware Pane Management — Creates separate panes for each directory/project
  • Command Execution — Run commands in tmux panes with captured output
  • Smart Output Capture — Uses unique markers to capture exactly the command output, regardless of buffer size
  • Multiple Session Support — Each Claude instance gets its own pane based on working directory
  • Session Persistence — Commands remain visible in tmux for user interaction
  • Interactive Prompt Detection — Automatically detects when commands require user input (passwords, confirmations, etc.)
  • Directory-Specific Logging — Commands are logged to .t-pane/logs/ in the current directory
  • Background Tasks — Launch Claude instances in background panes for research/analysis tasks

Installing the t pane mcp server

The server is distributed via npm as npm, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

The server reads one environment variable: T_PANE_DISABLE_LOGGING. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  • tmux installed and available in PATH - Must be run inside a tmux session for full functionality - Node.js 18+

Where it fits

File and storage servers are what separate an assistant that talks about your documents from one that actually works with them. T Pane sits in that group. Worth comparing against the other file systems servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by cni-locates-rumen, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the t pane mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the T Pane MCP server

{
  "mcpServers": {
    "t-pane": {
      "command": "npx",
      "args": ["-y", "npm"],
      "env": {
        "T_PANE_DISABLE_LOGGING": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • tmux installed and available in PATH - Must be run inside a tmux session for full functionality - Node.js 18+
VariableDescriptionRequired
T_PANE_DISABLE_LOGGINGConfiguration value read at startup.Optional

Frequently asked questions

It connects T Pane to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with T Pane directly.