How do I use tmux-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tmux-mcp Create a tmux session named 'dev' and run 'python app.py'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

tmux-mcp

by WENLIXIAO-CS

Overview Schema Related Servers Score Discussions

Python

Local

tmux-mcp

PyPI License: MIT

An MCP server for controlling tmux sessions. Allows AI assistants to create, manage, and interact with tmux sessions, windows, and panes programmatically.

Prerequisites

Python 3.10+
tmux installed and available on PATH

Installation

Claude Code (stdio)

claude mcp add tmux-mcp -- uvx tmux-mcp

Claude Code (HTTP)

# Start the server
tmux-mcp --transport streamable-http --port 8888

# Add to Claude Code
claude mcp add --transport http tmux-mcp http://localhost:8888/mcp

Claude Code (from GitHub)

claude mcp add tmux-mcp -- uvx --from git+https://github.com/WENLIXIAO-CS/tmux-mcp tmux-mcp

pip

pip install tmux-mcp

Available Tools

Sessions

Tool	Description
`tmux_list_sessions`	List all tmux sessions with names, IDs, window count, and attached status
`tmux_create_session`	Create a new detached session (returns session/window/pane IDs)
`tmux_rename_session`	Rename an existing session

Windows

Tool	Description
`tmux_list_windows`	List windows, optionally filtered by session (includes pane count)
`tmux_create_window`	Create a new window in a session (returns window/pane IDs)
`tmux_select_window`	Switch to a specific window
`tmux_rename_window`	Rename a window

Panes

Tool	Description
`tmux_list_panes`	List panes with IDs, dimensions, active status, and running command
`tmux_split_window`	Split a window/pane horizontally or vertically (returns new pane ID)
`tmux_select_pane`	Focus a specific pane
`tmux_resize_pane`	Resize a pane by direction+amount or absolute width/height

I/O

Tool	Description
`tmux_send_keys`	Send keys or commands to a pane (supports special keys like Enter, C-c, Tab)
`tmux_read_pane`	Capture visible content from a pane (supports scrollback history)
`tmux_read_cc_pane`	Monitor a Claude Code pane — auto-waits during processing, auto-approves permissions, returns output when idle

Lifecycle

Tool	Description
`tmux_kill`	Kill a session, window, or pane by target

Usage Examples

Create a session and run a command:

> Create a tmux session called "dev" and run "python server.py" in it

Tool call: tmux_create_session(name="dev")
-> Session 'dev' created. session_id=$1 window_id=@1 pane_id=%1

Tool call: tmux_send_keys(target="dev", keys="python server.py Enter")
-> Keys sent.

Read output from a pane:

> What's the output in the dev session?

Tool call: tmux_read_pane(target="dev")
-> $ python server.py
   Server running on port 8080

Split a window and run a second process:

> Split the dev window and start a log tail

Tool call: tmux_split_window(target="dev:0")
-> Pane created. pane_id=%2

Tool call: tmux_send_keys(target="%2", keys="tail -f app.log Enter")
-> Keys sent.

Monitor a Claude Code session (auto-wait + auto-approve):

> Run a task in the "cc" tmux session and wait for it to finish

Tool call: tmux_read_cc_pane(target="cc")
[  0.0s] Monitoring Claude Code pane 'cc'
[  0.0s] Permission requested: Do you want to → sending '1'
[  1.0s] Processing: Shimmying…
[  8.1s] Processing: · ↓ 345 tokens
[ 16.2s] Permission requested: 2. Yes, allow all edits → sending '1'
[ 32.4s] Processing: · ↓ 1.6k tokens
[115.3s] Idle: no activity indicators

-> (captured pane content with scrollback)

Development

git clone https://github.com/WENLIXIAO-CS/tmux-mcp.git
cd tmux-mcp
uv sync
uv run tmux-mcp

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WENLIXIAO-CS/tmux-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server