Skip to content
MCP server

MCP Tmux

Model Context Protocol server that lets LLMs collaboratively drive tmux

Runs locallyStatus and history
Pricing
Open source
Runs
Locally
Version
0.1.7
Listing updated
4 days ago

About MCP Tmux

MCP Tmux is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-tmux -- npx -y @k8ika0s/mcp-tmux

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-tmux": {
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-tmux": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@k8ika0s/mcp-tmux"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • MCP_TMUX_HOSTOptional default SSH host alias to use when none is provided.
  • MCP_TMUX_SESSIONOptional default tmux session name to use when none is provided.
  • TMUX_BINOptional path to tmux binary if not on PATH.
  • MCP_TMUX_TIMEOUT_MSTimeout in milliseconds for tmux/ssh invocations (default 15000).
  • MCP_TMUX_LOG_DIROverride log directory (defaults to ~/.config/mcp-tmux/logs).
  • MCP_TMUX_HOSTS_FILEOptional JSON file for per-host tmux PATH/bin overrides.

Pricing

Open source

MCP Tmux FAQ

Is MCP Tmux free?

Yes. MCP Tmux is open source, so you can use and self-host it for free.

How do I add MCP Tmux to Claude Code?

Run this command in your terminal: claude mcp add mcp-tmux -- npx -y @k8ika0s/mcp-tmux

What are the best alternatives to MCP Tmux?

The closest alternatives to MCP Tmux are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

Alternatives to MCP Tmux

  1. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  2. signafAIde

    MCP server

    Local MCP server to set up, verify and check coverage of signed agent action records

    Runs locally
    • 5 tools
    • Freemium
    • Security
  3. Toolkien

    MCP server

    One MCP gateway for all your MCP servers, with code mode, permissions and audit

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • AI models and LLM tooling
  4. Lugh

    MCP server

    Write, check and dry-run Lugh agent programs with policy, budgets and approvals

    Runs locally
    • 5 tools
    • Open source
    • AI models and LLM tooling
  5. HypePaper

    MCP server

    Research papers, benchmarks, citations and topic experts for AI assistants

    • 58 tools
    • Remote
    • Freemium
    • AI models and LLM tooling