How to add Tmux MCP Server to Claude Desktop

Let AI assistants read, control, and observe your tmux terminal sessions, windows, and panes. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 292★ · stdio · no auth

Claude Desktop config for Tmux MCP Server

npx -y tmux-mcp

{
  "mcpServers": {
    "tmux-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "tmux-mcp"
      ]
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Tmux MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Tmux MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js
tmux installed and running

What Tmux MCP Server can do in Claude Desktop

list-sessions

List all active tmux sessions.

find-session

Find a tmux session by name.

list-windows

List windows in a tmux session.

list-panes

List panes in a tmux window.

capture-pane

Capture content from a tmux pane.

create-session

Create a new tmux session.

create-window

Create a new window in a tmux session.

split-pane

Split a tmux pane horizontally or vertically with optional size.

Security

The execute-command tool runs arbitrary shell commands in your tmux panes on your local machine. The README explicitly warns to use it at your own risk. Only enable this server in trusted environments.

Tmux MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Tmux MCP Server config there under the "mcpServers" key and restart the client.

Is Tmux MCP Server safe to use with Claude Desktop?

How do I install it?

Add the server to your Claude Desktop config with command "npx" and args ["-y", "tmux-mcp"]. No separate install step is required beyond having Node.js and tmux.

Can I use a shell other than bash?

Yes. Pass --shell-type to the server (e.g. "--shell-type=fish"). It defaults to bash. The shell is only needed so the server can correctly read a command's exit status when executing commands.

Is it safe to let the model execute commands?

The execute-command tool runs arbitrary commands in your tmux panes, so it can affect your machine. The README explicitly says to use it at your own risk. Only use it in environments you trust.

View repo Full Tmux MCP Server page