Wezterm

Exposes WezTerm terminal control via MCP, enabling programmatic pane, tab, and workspace actions.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vaporif-wezterm-mcp": {
      "command": "node",
      "args": [
        "/path/to/wezterm-mcp/build/index.js"
      ]
    }
  }
}

You can control WezTerm terminals programmatically by exposing its pane, tab, and workspace actions through the MCP. This server lets your MCP clients list, read, and manipulate panes and windows as if you were issuing commands directly in WezTerm.

How to use

Connect your MCP client to the WezTerm MCP Server to begin issuing actions such as listing panes, spawning processes, splitting panes, moving focus, resizing panes, and renaming tabs or workspaces. You can chain commands to automate workflows that involve terminal layout, text input, and pane management across multiple clients.

How to install

Prerequisites you need before installing the server:

WezTerm installed and the wezterm CLI available on your PATH

Install the MCP server dependencies and build the project:

npm install
npm run build

Nix

If you use Nix, you can build and run the package directly with Nix:

nix build    # build the package
nix run      # run directly

Available tools

list_panes

List all windows, tabs and panes to inspect the current layout.

list_clients

List connected MCP clients to know who can issue commands.

get_text

Read the terminal screen and scrollback content for a given pane.

get_pane_direction

Identify the adjacent pane by a specified direction (up, down, left, right).

split_pane

Split a pane in a chosen direction to create a new pane.

spawn

Spawn a command in a new window or tab within the MCP-controlled WezTerm session.

send_text

Send text to a pane, supporting bracketed paste handling.

activate_pane

Focus a pane by its ID to bring it into input focus.

activate_pane_direction

Move focus to the pane in the specified directional relation.

kill_pane

Terminate a specified pane.

adjust_pane_size

Resize a pane in a chosen direction to adjust layout.

zoom_pane

Zoom or unzoom a pane to maximize its area.

move_pane_to_new_tab

Move a pane into a new tab for organization.

activate_tab

Activate a tab by ID, index, or relative offset.

set_tab_title

Change the title of a tab for easier navigation.

set_window_title

Change the window title to reflect current activity.

rename_workspace

Rename a workspace to reflect its purpose or content.