Skip to main content

MCP server for tmux operations

Project description

tmux-mcp-tools

Provide MCP tools for interacting with tmux sessions.

Tmux Configuration

Add the following to your .tmux.conf file to create a keybinding that opens the client in a new pane:

bind-key M-k split-window -h -p 33 "uvx --from tmux-mcp-tools tmux-agent --target $(tmux display-message -p '#{pane_index}');"

This will bind Alt+K to open a new pane with the client, targeting the current pane.

Features

  • tmux_capture_pane: Capture the content of a tmux pane
  • tmux_send_command: Send commands to a tmux pane with automatic Enter key
  • tmux_write_file: Write content to a file using heredoc pattern in a tmux pane

Usage

{
  "mcpServers": {
   "tmux-mcp-tools": {
      "command": "uvx",
      "args": ["tmux-mcp-tools"]
    }
  }
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tmux_mcp_tools-0.2.0.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tmux_mcp_tools-0.2.0-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file tmux_mcp_tools-0.2.0.tar.gz.

File metadata

  • Download URL: tmux_mcp_tools-0.2.0.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for tmux_mcp_tools-0.2.0.tar.gz
Algorithm Hash digest
SHA256 49ed7a12e5580f5e189f013f488648133079696ea77d9c14352932f82131f404
MD5 58ec13533626b868bebc5fcd63fffd74
BLAKE2b-256 6da024689d08e2adf4a430f558adfb7811d7a2a667872bb91e18663fca6d0827

See more details on using hashes here.

File details

Details for the file tmux_mcp_tools-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: tmux_mcp_tools-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for tmux_mcp_tools-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3fc4aa5f319228972c1628f77d9c05cae45435d04f050bf8b38840b81ef95de7
MD5 4c0cce3ab9653a24bcdd9076a67c22c8
BLAKE2b-256 f16881f26f3180f41a35d3f8099ca898f6c65b2e752c1eee9dfd4eeaa9b1ec5c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page