Which integrations are available for this server?

Exposes tools for controlling and automating the WezTerm terminal emulator, allowing for programmatic management of panes, tabs, and windows, as well as the ability to read terminal content and send text to active sessions.

How do I use wezterm-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., "@wezterm-mcp split the current pane and run npm start" 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.

mcp-server-wezterm

MCP server that exposes WezTerm terminal control via the Model Context Protocol.

Requirements

Rust 1.75+ (or Nix)
WezTerm with wezterm cli available on PATH

Install

From source

cargo build --release
# binary at target/release/mcp-server-wezterm

Nix

nix run github:vaporif/mcp-server-wezterm

Usage

Add to your MCP client configuration (e.g. Claude Code ~/.claude.json):

{
  "mcpServers": {
    "wezterm": {
      "command": "/path/to/mcp-server-wezterm"
    }
  }
}

Or with rvx (no Rust toolchain needed and no installation required):

{
  "mcpServers": {
    "qdrant": {
      "command": "rvx mcp-server-wezterm",
    }
  }
}

Tools

Tool	Description
`list_panes`	List all windows, tabs and panes
`list_clients`	List connected clients
`get_text`	Read terminal screen/scrollback content
`get_pane_direction`	Get adjacent pane ID in a direction
`split_pane`	Split a pane (left/right/top/bottom)
`spawn`	Spawn a command in a new window or tab
`send_text`	Send text to a pane (bracketed paste)
`activate_pane`	Focus a pane by ID
`activate_pane_direction`	Focus adjacent pane by direction
`kill_pane`	Kill a pane
`adjust_pane_size`	Resize a pane directionally
`zoom_pane`	Zoom/unzoom/toggle a pane
`move_pane_to_new_tab`	Move a pane into a new tab
`activate_tab`	Activate a tab by ID, index, or relative offset
`set_tab_title`	Change tab title
`set_window_title`	Change window title
`rename_workspace`	Rename a workspace

Development

cargo run             # Run in dev mode
cargo build --release # Release build
cargo clippy          # Lint
cargo test            # Test
nix develop           # Nix devShell with wezterm + cargo-nextest

License

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

wezterm-mcp