Tmux MCP Server

by nickgnd
MIT License
8
3
  • Linux
  • Apple

Integrations

  • Provides tools for listing, navigating, and interacting with tmux sessions, windows and panes. Enables capturing terminal content, executing commands in panes, and creating new tmux sessions and windows.

Tmux MCP Server

Model Context Protocol server that 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.

Features

  • 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 (use it at your own risk ⚠️)
  • Create new tmux sessions and windows

Check out this short video to get excited!

Prerequisites

  • Node.js
  • tmux installed and running

Usage

Configure Claude Desktop

Add this MCP server to your Claude Desktop configuration:

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

MCP server options

You can optionally specify the command line shell you are using, if unspecified it defaults to bash

"mcpServers": { "tmux": { "command": "npx", "args": ["-y", "tmux-mcp", "--shell-type=fish"] } }

The MCP server needs to know the shell only when executing commands, to properly read its exit status.

Available Resources

  • tmux://sessions - List all tmux sessions
  • tmux://pane/{paneId} - View content of a specific tmux pane
  • tmux://command/{commandId}/result - Results from executed commands

Available Tools

  • 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
  • execute-command - Execute a command in a tmux pane
  • get-command-result - Get the result of an executed command
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables Claude Desktop to interact with and view tmux session content, allowing AI assistants to read from, control, and observe terminal sessions.

  1. Features
    1. Prerequisites
      1. Usage
        1. Configure Claude Desktop
        2. MCP server options
      2. Available Resources
        1. Available Tools

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A robust SSH server facilitating secure remote command execution with TMUX session management, multi-window support, and smart session recovery for improved AI-human interaction.
            Last updated -
            4
            Python
          • A
            security
            F
            license
            A
            quality
            A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
            Last updated -
            1
            5
            Python
            • Apple
          • -
            security
            A
            license
            -
            quality
            Connects Claude Desktop to Hugging Face Spaces with minimal setup, enabling capabilities like image generation, vision tasks, text-to-speech, and chat with AI models.
            Last updated -
            188
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            Enables Claude and other AI assistants to interact with your computer's audio system, allowing for recording from microphones and playing audio through speakers.
            Last updated -
            1
            Python
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          ID: 3o3o9iph0m