libtmux-mcp server
tmux MCP server powered by libtmux
Ads
Overview
Terminal control for AI agents, built on libtmux and FastMCP. This server maps tmux’s object hierarchy — sessions, windows, panes — into MCP tools. Some tools read state. Some mutate it. Some destroy. The distinction is explicit and enforced. > [!warning] Warning > Pre-alpha. APIs may change. Feedback welcome. Read tmux state without changing anything. list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_readonly_tools_batch
Installation
claude mcp add tmux -- uvx libtmux-mcp
Configuration
Configuration example is not available yet.
Capabilities
- Inspect tmux state read-only
Ask to `list_sessions`, `capture_pane`, or `search_panes` to view sessions, windows, and panes without modifying anything.
- Drive terminal interactions
Use `send_keys`, `run_command`, or `paste_text` to type commands, execute programs, and paste content into panes.
- Manage tmux layout
Create or split windows with `create_window` and `split_window`, then navigate via `select_pane` or `select_window`.
- Tear down tmux objects
Kill sessions, windows, panes, or the entire server with `kill_session`, `kill_window`, `kill_pane`, or `kill_server`.
- Batch related operations
Combine multiple read-only or mutating calls in one request via `call_readonly_tools_batch` or `call_mutating_tools_batch`.
- Suppress shell history
Create sessions or windows with `suppress_persistent_history=true` to keep test commands out of persistent shell history.
Tags
- development
- devops
- ssh
Related MCP servers
Context7 MCP
OfficialOfficial Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.
Chrome DevTools MCP
OfficialOfficial Chrome DevTools MCP server for controlling and inspecting a live Chrome browser from coding agents such as Gemini, Claude, Cursor, and Copilot.
Mastra/mcp
OfficialClient implementation for Mastra, providing seamless integration with MCP-compatible AI models and tools.
GitHub MCP Server
OfficialConnect your AI assistant to GitHub repositories, issues, pull requests, and search.