Advertise
MCP.so
Sign In

Tmux MCP Server

@fr1sk

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

fr1sk

Submitted by

fr1sk

About Tmux MCP Server

No overview available yet

#tmux#terminal#mcp#developer-tools#shell#bash#logs#log#debugging#debug#claude#cursor#windsurf#opencode#codex#cline#ai-tools

Tmux MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp"
    }
  }
}

Tmux MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is tmux-mcp?

tmux-mcp is an MCP server that gives AI assistants full visibility into your tmux sessions — browse sessions, windows, and panes, read terminal output, and send commands. It works with Claude Code, OpenCode, Cursor, Windsurf, and any MCP‑compatible host. Optionally, it can route all shell commands through a named tmux session for live auditing.

How to use tmux-mcp?

Install globally with npm install -g @fr1sk/tmux-mcp, then add a local MCP server entry in your client’s config (OpenCode, Claude Code, Cursor/Windsurf). Use tools like list_sessions, capture_pane, send_keys, etc. Environment variables TMUX_MCP_ALWAYS_USE and TMUX_MCP_DEFAULT_SESSION control whether all shell commands are forced through tmux.

Key features of tmux-mcp

  • List all active tmux sessions with window count and status
  • Capture visible pane output with up to 5 000 lines of scrollback
  • Send shell commands or raw key sequences to any pane
  • Create, rename, split, and delete sessions / windows / panes
  • Error‑safe: returns readable messages instead of crashing on bad targets
  • Configurable wait time before capturing pane output after sending keys

Use cases of tmux-mcp

  • Browse tmux state and discover active sessions, windows, and panes
  • Read logs, compiler errors, server output, or test runs from a pane
  • Send commands (e.g., git status, npm test) and immediately read the result
  • Create new tmux sessions for projects and run commands in them
  • Route all AI‑driven shell commands through tmux for full auditability

Frequently asked questions

1

What MCP hosts are compatible with tmux-mcp?

Works with Claude Code, OpenCode, Cursor, Windsurf, and any MCP‑compatible host.

2

How do I target a specific pane for commands or capture?

Use tmux’s standard `session:window.pane` notation (e.g., `work:0.0`). Use `list_sessions`, `list_windows`, and `list_panes` to discover correct targets.

3

Can I force all AI shell commands to go through tmux?

Yes. Set the environment variable `TMUX_MCP_ALWAYS_USE` to `"true"` and optionally `TMUX_MCP_DEFAULT_SESSION` to a session name.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise