Skip to main content
Glama

Tmux MCP Server

by nickgnd
MIT License
8
25
  • Linux
  • Apple

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

          • A
            security
            A
            license
            A
            quality
            A bridge allowing Claude Desktop to access Telegram chats and messages via the Model Context Protocol, providing read-only capabilities to retrieve dialogs and messages from Telegram.
            Last updated -
            2
            38
            Python
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            Allows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.
            Last updated -
            19
            11,148
            3,479
            JavaScript
            MIT License
            • Apple
          • -
            security
            F
            license
            -
            quality
            A companion desktop app enabling bi-directional interaction between Claude Desktop and visual UI elements, allowing Claude to display, read from, and write to interactive interfaces while processing user events and feedback.
            Last updated -
            5
            1
            TypeScript
            • Apple
          • -
            security
            A
            license
            -
            quality
            A server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.
            Last updated -
            11,148
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/nickgnd/tmux-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server