Skip to content
Back to search

tmux-mcp

A MCP server for our beloved terminal multiplexer tmux.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nickgnd--tmux-mcp/badge.svg)](/listings/nickgnd--tmux-mcp)

HTML

<a href="/listings/nickgnd--tmux-mcp"><img src="/api/listings/nickgnd--tmux-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 77 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Tmux MCP Server
  2. 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.
  3. ## Features
  4. - List and search tmux sessions
  5. - View and navigate tmux windows and panes
  6. - Capture and expose terminal content from any pane
  7. - Execute commands in tmux panes and retrieve results (use it at your own risk ⚠️)
  8. - Create new tmux sessions and windows
  9. - Split panes horizontally or vertically with customizable sizes
  10. - Kill tmux sessions, windows, and panes
  11. Check out this short video to get excited!
  12. </br>
  13. [![youtube video](http://i.ytimg.com/vi/3W0pqRF1RS0/hqdefault.jpg)](https://www.youtube.com/watch?v=3W0pqRF1RS0)
  14. ## Prerequisites
  15. - Node.js
  16. - tmux installed and running
  17. ## Usage
  18. ### Configure Claude Desktop
  19. Add this MCP server to your Claude Desktop configuration:
  20. ```json
  21. "mcpServers": {
  22. "tmux": {
  23. "command": "npx",
  24. "args": ["-y", "tmux-mcp"]
  25. }
  26. }
  27. ```
  28. ### MCP server options
  29. You can optionally specify the command line shell you are using, if unspecified it defaults to `bash`
  30. ```json
  31. "mcpServers": {
  32. "tmux": {
  33. "command": "npx",
  34. "args": ["-y", "tmux-mcp", "--shell-type=fish"]
  35. }
  36. }
  37. ```
  38. The MCP server needs to know the shell only when executing commands, to properly read its exit status.
  39. ## Available Resources
  40. - `tmux://sessions` - List all tmux sessions
  41. - `tmux://pane/{paneId}` - View content of a specific tmux pane
  42. - `tmux://command/{commandId}/result` - Results from executed commands
  43. ## Available Tools
  44. - `list-sessions` - List all active tmux sessions
  45. - `find-session` - Find a tmux session by name
  46. - `list-windows` - List windows in a tmux session
  47. - `list-panes` - List panes in a tmux window
  48. - `capture-pane` - Capture content from a tmux pane
  49. - `create-session` - Create a new tmux session
  50. - `create-window` - Create a new window in a tmux session
  51. - `split-pane` - Split a tmux pane horizontally or vertically with optional size
  52. - `kill-session` - Kill a tmux session by ID
  53. - `kill-window` - Kill a tmux window by ID
  54. - `kill-pane` - Kill a tmux pane by ID
  55. - `execute-command` - Execute a command in a tmux pane
  56. - `get-command-result` - Get the result of an executed command

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.