Skip to main content

claude-tmux-mcp

MCP server for claude-tmux agent orchestration.

Installation

pip install claude-tmux-mcp

Or as an optional extra:

pip install "claude-tmux[mcp]"

Usage

claude-tmux-mcp  # Starts FastMCP server on stdio

Add to your Claude Code MCP config:

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

Tools

Namespace Tool Description
agent.* list List agents with optional status/session filters
get Get agent by pane ID
create Create agent with optional worktree
kill Kill agent by name
wait_ready Poll until agents reach "stop" status
prompt Send prompt and wait for response
tmux.* capture_pane Capture pane output
send_keys Send keys to pane
events.* list Query event log

See the main claude-tmux repo for full documentation.

Metadata

Release files for claude-tmux-mcp 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for claude-tmux-mcp 1.2.0
File Size Uploaded
claude_tmux_mcp-1.2.0.tar.gz 8.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for claude-tmux-mcp 1.2.0
File Interpreter ABI Platform
claude_tmux_mcp-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.8 kB

Release files / claude_tmux_mcp-1.2.0.tar.gz

Download URL claude_tmux_mcp-1.2.0.tar.gz
Size 8.1 kB
Tags Source
SHA-256 checksum
How to use checksums
3406d2584e1ad3fea403d41815cdd69aae0a0b4b410abf3ca2450f20aa2d774d
BLAKE2b-256 checksum
How to use checksums
74ef3947b0acfc4c1f64dada237bfb5e6facc05edaae4cdf95d27c946f3fbd3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / claude_tmux_mcp-1.2.0-py3-none-any.whl

Download URL claude_tmux_mcp-1.2.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ab5288c55389052b98f1018e8e2265b3a0c331764d6e0dba12b61d71e4785784
BLAKE2b-256 checksum
How to use checksums
73b25b0e4b31447672745830d9766cdd70474dc9524c9f3cabe8591e5d9cd422
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page