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 -t ! -p '#{pane_id}')\" ;"

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.1.tar.gz (8.2 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.1-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tmux_mcp_tools-0.2.1.tar.gz
  • Upload date:
  • Size: 8.2 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.1.tar.gz
Algorithm Hash digest
SHA256 59dc4c865924d1b46bcb8c53701a38b4b7fbdc06210413468a5052d276398ae0
MD5 fe74957a41c32eba33b22fd8a9628c32
BLAKE2b-256 4a8557a27a81b64b0c53e50917696309a0faa71f6f8f4d8b2493a5d49c26bb92

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tmux_mcp_tools-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 9.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6f872bf2f88f9bd61304af779a67c4dcd90c25fc2f65be718da5b278859273c1
MD5 698fadf25595b5761f4aaa20e6779574
BLAKE2b-256 50effef42433d7764614dab70051a2d6d47d0b0d3a775daa2fe6ae14c232f6b9

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